Skip to main content
GET
/
api
/
v1
/
developer
/
trading
/
hyperliquid
/
orderbook
/
snapshot
Orderbook Snapshot Endpoint
curl --request GET \
  --url https://api.allium.so/api/v1/developer/trading/hyperliquid/orderbook/snapshot \
  --header 'X-API-KEY: <api-key>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
This endpoint provides a complete snapshot of the orderbook for all trading pairs with approximately 5-second freshness.
Compression RequiredThis endpoint requires brotli compression for efficient data transfer.

​
Response Structure

The response is an array of orderbook snapshots, where each entry contains:
  • Pair identifier - Trading pair (e.g., @1, @10)
  • Bids array - Buy orders sorted by price
  • Asks array - Sell orders sorted by price

​
Example Response

Freshness is ~5s. 
[
  [
    "0G", <-- Pair
    {
      "book_orders": [
        [ <-- Bids
          [
            "0x010461c14e146ac35fe42271bdc1134ee31c703a", <-- User
            {
              "coin": "0G",
              "side": "B",
              "limitPx": "2.1293",
              "sz": "779.0",
              "oid": 201304032517,
              "timestamp": 1760539060740,
              "triggerCondition": "N/A",
              "isTrigger": false,
              "triggerPx": "0.0",
              "children": [],
              "isPositionTpsl": false,
              "reduceOnly": false,
              "orderType": "Limit",
              "origSz": "779.0",
              "tif": "Alo",
              "cloid": null
            }
          ],
          [
            "0x31ca8395cf837de08b24da3f660e77761dfb974b", <-- User
            {
              "coin": "0G",
              "side": "B",
              "limitPx": "2.1293",
              "sz": "785.0",
              "oid": 201304032627,
              "timestamp": 1760539060795,
              "triggerCondition": "N/A",
              "isTrigger": false,
              "triggerPx": "0.0",
              "children": [],
              "isPositionTpsl": false,
              "reduceOnly": false,
              "orderType": "Limit",
              "origSz": "785.0",
              "tif": "Alo",
              "cloid": null
            }
          ],
        ],
        [ <-- Asks
          ...
        ]

Authorizations

​
X-API-KEY
string
header
required

Response

Successful response