{precision}: Order book

API: bitfinex.com:bitfinex
Endpoint: /book/{symbol}/{precision}
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 276ms

Description

Returns the order book for a trading pair showing bid and ask orders at different price levels. Use this to see current market depth, liquidity, and spread. Positive amounts are bids, negative are asks.

From spec: Returns the order book for a trading pair or funding currency. Precision P0-P4 are aggregated levels; R0 is raw.

Usage Tips

- Precision levels: P0 (raw), P1-P4 (aggregated with decreasing precision) - Symbol format: tBTCUSD for trading pairs, fUSD for funding - Query param 'len' controls entries per side (1-25 for P1-P4, 1-100 for P0) - Rate limit: 10-60 requests/min depending on endpoint

Parameters (3)

len (integer, query, optional, default: 25)

Number of price levels to return (1, 25, 100, or 250)

Constraints: {'enum': [1, 25, 100, 250]}

precision (string, path, required)

Price precision level: P0, P1, P2, P3, P4 (aggregated), or R0 (raw)

Constraints: {'enum': ['P0', 'P1', 'P2', 'P3', 'P4', 'R0']}

symbol (string, path, required)

Trading pair or funding currency symbol

Examples (1)

Get BTC/USD order book with raw precision probe-gate

Demonstrates fetching the full order book for Bitcoin with raw precision (P0), showing 25 price levels per side

curl 'https://api-pub.bitfinex.com/v2/book/tBTCUSD/P0?len=25'
import requests

resp = requests.get(
    "https://api-pub.bitfinex.com/v2/book/tBTCUSD/P0",
    params={
        'len': '25',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("bitfinex")
result = api.fetch("book/{symbol}/{precision}", len=25)

for item in result:
    print(item)
const resp = await fetch("https://api-pub.bitfinex.com/v2/book/tBTCUSD/P0?len=25");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 04:02:44.813248 200 276ms
2026-04-15 02:15:58.223524 200 188ms
2026-04-14 03:02:47.304711 200 185ms
2026-04-12 14:47:21.869661 200 249ms
2026-04-10 02:15:54.295219 200 122ms
2026-04-09 00:49:45.244300 200 469ms
2026-04-08 00:31:44.871290 200 178ms
2026-04-07 01:20:44.755096 200 172ms
2026-04-06 06:53:13.608737 200 216ms
2026-04-05 03:44:51.028434 200 199ms