Skip to main content

Order Book Depth

Order book snapshot for a futures symbol. Passthrough of Binance USDⓈ-M Futures /fapi/v1/depth.

Endpoint

GET /fapi/v1/depth

Authentication: Public.

Query parameters

NameTypeRequiredDefaultNotes
symbolstringYesUppercase futures symbol.
limitintegerNo100Number of price levels per side. Binance accepts 5, 10, 20, 50, 100, 500, 1000.

Response — 200 OK

{
"lastUpdateId": 1234567890,
"E": 1745920800000,
"T": 1745920800000,
"bids": [
["67890.10", "1.234"],
["67890.00", "0.500"]
],
"asks": [
["67891.00", "0.800"],
["67891.10", "2.100"]
]
}

Each bid/ask is [price, quantity] as decimal strings.

Errors

HTTPCause
422Missing symbol.
502Upstream Binance request failed.

Example

curl -s "https://api.pipai.org/fapi/v1/depth?symbol=BTCUSDT&limit=20"