Retrieve the Level 2 order book snapshot for a specific asset. Returns at most 20 levels per side (bids and asks) with price, size, and order count information.
info
endpoint with type: "l2Book"
retrieves a Level 2 order book snapshot for a specific asset on the Hyperliquid exchange. This endpoint provides real-time market depth information showing the best bid and ask prices with their corresponding quantities and order counts.
type
(string, required) — The request type. Must be "l2Book"
to retrieve order book snapshot.coin
(string, required) — Asset identifier (simple names like “BTC”, “ETH” for perpetuals; spot format like “@107” for spot trades).nSigFigs
(integer, optional) — Optional field to aggregate levels to nSigFigs
significant figures. Valid values are 2, 3, 4, 5, and null
(full precision).mantissa
(integer, optional) — Optional field to aggregate levels. This field is only allowed if nSigFigs is 5. Accepts values of 1, 2 or 5.[bids, asks]
px
— Price level as a string for precisionsz
— Total size (quantity) at this price level as a stringn
— The number of different orders that comprise this levelnSigFigs
):
2
— Aggregate to 2 significant figures (e.g., 12000, 1200)3
— Aggregate to 3 significant figures (e.g., 12300, 1230)4
— Aggregate to 4 significant figures (e.g., 12340, 1234)5
— Aggregate to 5 significant figures (e.g., 12345, 1234.5)null
— Full precision (no aggregation)nSigFigs
is 5):
1
— Round to nearest 1 (e.g., 12345)2
— Round to nearest 2 (e.g., 12344, 12346)5
— Round to nearest 5 (e.g., 12345, 12350)n
field):
info
endpoint with type: "l2Book"
is essential for applications that need to:
Successful response with L2 order book data
Array containing two arrays: [bids, asks]. Each side contains up to 20 price levels.