`get_order_book`

Order book · read-only, idempotent, no account needed · scopes: read

Order book levels for one perpetual futures contract on one exchange, best first, as [price, size]. Use to judge liquidity before a large market order. Not for the best price across exchanges (use compare_perp_quotes_across_venues). Inputs: symbol, venue (without an account: hyperliquid only), depth (1-50 levels). Prices in USD per coin, sizes in the base coin. Next: preview_perp_order.

Call it

MCP tools/call

{"name": "get_order_book", "arguments": {"symbol": "BTC"}}

REST

GET /v1/markets/{symbol}/book

Inputs

Name	Meaning (* required)
`symbol` *	Base coin, e.g. BTC
`venue`	Venue: sandbox, hyperliquid, okx, bybit or binance. Omitted: the agent's only venue, else hyperliquid, else your only connected venue, else sandbox
`depth`	Levels per side

Returns

Field	Meaning and unit
`venue`	Venue name
`symbol`	Base coin
`bids`	[price (USD per coin), size (in the base coin (e.g. BTC), not USD)], best first
`asks`	[price (USD per coin), size (in the base coin (e.g. BTC), not USD)], best first

Rejections: error codes, each with what to do.