books: Get order book

API: okx.com:okx-api
Endpoint: /market/books
Response format: unknown
Auth: unknown
Method: GET
Last Status: 200
Latency: 496ms

Description

Retrieve order book data (bids and asks) for a trading pair.

Parameters (2)

instId (string, query, required)

Instrument ID (e.g., BTC-USDT)

sz (string, query, optional, default: 1)

Order book depth (1-400 for consolidated, 1-5000 for non-consolidated)

Examples (2)

Get order book openapi-spec
curl 'https://www.okx.com/api/v5/market/books?instId=BTC-USDT'
import requests

resp = requests.get(
    "https://www.okx.com/api/v5/market/books",
    params={
        'instId': 'BTC-USDT',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("okx")
result = api.fetch("market/books", instId="BTC-USDT")

for item in result:
    print(item)
const resp = await fetch("https://www.okx.com/api/v5/market/books?instId=BTC-USDT");
const data = await resp.json();
Get order book probe-gate
curl 'https://www.okx.com/api/v5/market/books?instId=BTC-USDT&sz=1'
import requests

resp = requests.get(
    "https://www.okx.com/api/v5/market/books",
    params={
        'instId': 'BTC-USDT',
        'sz': '1',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("okx")
result = api.fetch("market/books", instId="BTC-USDT", sz=1)

for item in result:
    print(item)
const resp = await fetch("https://www.okx.com/api/v5/market/books?instId=BTC-USDT&sz=1");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 04:21:05.257833 200 496ms
2026-04-16 00:41:34.876537 200 347ms
2026-04-15 03:08:40.144252 200 442ms
2026-04-15 01:27:34.895753 200 338ms
2026-04-14 03:03:31.120337 200 479ms
2026-04-14 02:51:59.486634 200 572ms
2026-04-12 16:51:21.610019 200 327ms
2026-04-12 16:30:12.400885 200 337ms
2026-04-10 00:18:03.311459 200 478ms
2026-04-10 00:01:30.081754 200 872ms
2026-04-09 01:36:31.968796 200 385ms
2026-04-09 00:16:44.361646 200 378ms
2026-04-03T10:19:26.241876 200 288ms