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>'
This response does not have an example.
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

[
  [
    "@1", <-- Pair
    [
      [ <-- Bids
        {
          "coin": "@1",
          "side": "B",
          "limitPx": "17.098",
          "sz": "100.0",
          "oid": 128354605198,
          "timestamp": 1754543907080,
          "triggerCondition": "N/A",
          "isTrigger": false,
          "triggerPx": "0.0",
          "children": [],
          "isPositionTpsl": false,
          "reduceOnly": false,
          "orderType": "Limit",
          "origSz": "100.0",
          "tif": "Alo",
          "cloid": null
        }
      ],
      [ <-- Asks
        {
          "coin": "@1",
          "side": "A",
          "limitPx": "17.149",
          "sz": "59.23",
          "oid": 128354605199,
          "timestamp": 1754543907080,
          "triggerCondition": "N/A",
          "isTrigger": false,
          "triggerPx": "0.0",
          "children": [],
          "isPositionTpsl": false,
          "reduceOnly": false,
          "orderType": "Limit",
          "origSz": "99.17",
          "tif": "Alo",
          "cloid": null
        }
      ]
    ]
  ],
  [
    "@10", <-- Next pair
    [
      [
        // Bids...
      ],
      [
        // Asks...
      ]
    ]
  ]
]

Authorizations

​
X-API-KEY
string
header
required

Response

Successful response

⌘I