DH
4 min read·Updated 2026-06-14

Read liquidation levels

Long/short liquidation totals per daily price bucket.

GET/networks/{network}/liquidity-levels

Liquidity levels aggregate open positions by liquidation-price bucket, counting only positions with a known liquidation_price. Pass fromDate and toDate in YYYY-MM-DD; the window spans at most 90 days and aggregates by day.

Path Params
networkstringrequired

Network identifier. Only hyperliquid is supported.

Example: hyperliquid

Query Params
fromDatestringrequired

Start date in YYYY-MM-DD format.

Example: 2026-06-01

toDatestringrequired

End date in YYYY-MM-DD format. Must be ≥ fromDate.

Example: 2026-06-12

assetstring

Filter to a single canonical asset.

Example: BTC

limitinteger

Maximum daily rows per page.

Example: 30

cursorstring

Cursor from the previous page's nextCursor field.

Responses

200OK

Daily liquidation-level aggregates bucketed by price.

Schema
fromDatestring (YYYY-MM-DD)

Resolved start date of the window.

toDatestring (YYYY-MM-DD)

Resolved end date of the window.

granularitystring

Aggregation granularity — always day.

itemsobject[]

Daily aggregate rows.

datestring (YYYY-MM-DD)

Calendar day for the aggregate.

networkstring

Network identifier.

canonicalAssetstring

Canonical asset symbol.

networkAssetSymbolstring

Network-specific asset symbol.

assetAliasstringnullable

Display alias for the asset, when set.

coveragestring

Coverage scope for the row.

bucketSizestring (decimal)

Price width of each liquidation bucket.

bucketMethodstring

How prices are mapped to buckets, e.g. nearest.

updatedAtstring (ISO 8601)nullable

When the day's aggregate was last updated.

totalsobject

Long and short totals across all buckets.

longobject

Long-side totals.

positionCountinteger

Long positions in the day.

totalAmountUsdstring (decimal)

Long notional in USD.

shortobject

Short-side totals.

positionCountinteger

Short positions in the day.

totalAmountUsdstring (decimal)

Short notional in USD.

levelsobject[]

Per-bucket liquidation levels.

sidestring

Position side — long or short.

bucketPricestring (decimal)

Representative price of the bucket.

positionCountinteger

Positions in this bucket.

totalAmountUsdstring (decimal)

Notional in this bucket.

minLiquidationPricestring (decimal)

Lowest liquidation price in the bucket.

maxLiquidationPricestring (decimal)

Highest liquidation price in the bucket.

nextCursorstringnullable

Cursor for the next page, or null at the end.

400Bad Request
401Unauthorized
404Not Found
500Server Error
Request
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/liquidity-levels?asset=BTC&fromDate=2026-06-01&toDate=2026-06-12&limit=1" \
  -H "X-API-Key: hlsk_your_developer_key"
Response
200 · OK
{
  "fromDate": "2026-06-01",
  "toDate": "2026-06-12",
  "granularity": "day",
  "items": [
    {
      "date": "2026-06-12",
      "network": "hyperliquid",
      "canonicalAsset": "BTC",
      "networkAssetSymbol": "BTC",
      "coverage": "current",
      "bucketSize": "100",
      "bucketMethod": "nearest",
      "totals": {
        "long": { "positionCount": 118, "totalAmountUsd": "111386355" },
        "short": { "positionCount": 94, "totalAmountUsd": "56587359" }
      },
      "levels": [
        {
          "side": "long",
          "bucketPrice": "60400",
          "positionCount": 8,
          "totalAmountUsd": "12600000",
          "minLiquidationPrice": "60350.5",
          "maxLiquidationPrice": "60449.9"
        }
      ]
    }
  ],
  "nextCursor": "1"
}