Skip to main content
POST
/
v1
/
info
/
l2Book
Get L2 Order Book
curl --request POST \
  --url https://api.hypereth.io/v1/info/l2Book \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "l2Book",
  "coin": "BTC",
  "nSigFigs": 5
}'
{
  "levels": [
    [
      [
        {
          "px": "43250.5",
          "sz": "2.5",
          "n": 3
        }
      ]
    ]
  ],
  "time": 123
}

Body

application/json
type
enum<string>
required

Request type identifier

Available options:
l2Book
coin
string
required

Trading pair symbol

Example:

"BTC"

nSigFigs
integer
default:5

Number of significant figures for price precision

Required range: 1 <= x <= 6
mantissa
integer

Mantissa for price level grouping

dex
string
default:""

Perp dex name for multi-dex support

Response

Order book snapshot

Level 2 order book snapshot

levels
object[][][]
required

Array of [bids, asks]

Represents a price level in the order book with aggregated size. Used in L2 order book snapshots.

time
integer
required

Snapshot timestamp in milliseconds