10 min read·Updated 2026-06-12

Markets

Market snapshots, scanned-wallet positions, and liquidation-level aggregates for tracked Hyperliquid assets.

Use market data correctly

Market endpoints combine current exchange quote context with DexHunt aggregates over scanned wallets. They are useful for asset discovery, long-short positioning, liquidation-map summaries, and drilling into the wallets behind an asset.

Coverage note

Position endpoints serve open positions from scanned wallets. The endpoint name whale-positions is stable for compatibility, but collection is not limited to one-million dollar positions.

List markets

Use GET /markets to list all tracked assets. Sort keys are volume24h, openInterest, change24hPct, and totalLiquidationValue. Use order=asc for ascending order; any other value sorts descending.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets?sort=openInterest&order=desc" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "items": [
    {
      "symbol": "BTC",
      "price": "67000.5",
      "change24hPct": "1.42",
      "volume24h": "1850000000",
      "openInterest": "910000000",
      "funding": "0.0000125",
      "longCount": 118,
      "shortCount": 94,
      "longShortRatio": "1.255319",
      "totalLiquidationValue": "167973714",
      "longLiquidationValue": "111386355",
      "shortLiquidationValue": "56587359"
    }
  ],
  "coverage": "scanned_wallets"
}

Open market detail

Use GET /markets/{asset} when you already know the canonical asset or network symbol. The response shape is the same as a single item from GET /markets.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "symbol": "BTC",
  "price": "67000.5",
  "change24hPct": "1.42",
  "volume24h": "1850000000",
  "openInterest": "910000000",
  "funding": "0.0000125",
  "longCount": 118,
  "shortCount": 94,
  "longShortRatio": "1.255319",
  "totalLiquidationValue": "167973714",
  "longLiquidationValue": "111386355",
  "shortLiquidationValue": "56587359"
}

List market positions

Use market positions to inspect the wallets that currently hold an open position in an asset. The optional direction is long or short. The default limit is 25 and the hard cap is 200.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC/whale-positions?direction=long&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "items": [
    {
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "tags": ["whale", "high_quality"],
      "symbol": "BTC",
      "direction": "long",
      "positionValue": "3000000.00",
      "liqPrice": "60350.5",
      "observedAt": "2026-06-12T12:00:00Z",
      "leverage": "5",
      "size": "44.75",
      "sizeUnit": "BTC",
      "uPnl": "38000.10",
      "uPnlPct": "6.33",
      "entryPrice": "66150.2",
      "markPrice": "67000.5",
      "margin": "600000.00",
      "fundingCost": "-1200.45"
    }
  ],
  "nextCursor": "2",
  "coverage": "scanned_wallets"
}

Read liquidation levels

Liquidity levels aggregate open positions by liquidation-price bucket. The endpoint only includes positions with a known liquidation_price. Required dates use YYYY-MM-DD. The default maximum read window is 90 days.

fromDate

Start date for daily aggregate rows. Required.

fromDate=2026-06-01

toDate

End date for daily aggregate rows. Required and must be greater than or equal to fromDate.

toDate=2026-06-12

asset

Optional asset filter. The external parameter is named asset.

asset=BTC

paging

The response granularity is day. Use nextCursor for the next page.

granularity=day

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/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"

Example response

json

{
  "fromDate": "2026-06-01",
  "toDate": "2026-06-12",
  "granularity": "day",
  "items": [
    {
      "date": "2026-06-12",
      "network": "hyperliquid",
      "canonicalAsset": "BTC",
      "networkAssetSymbol": "BTC",
      "assetAlias": "BTC",
      "coverage": "current",
      "bucketSize": "100",
      "bucketMethod": "nearest",
      "updatedAt": "2026-06-12T12:05:00Z",
      "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"
}

What to do next

Use the market endpoints as a discovery layer before querying historical series. For a chart or time-window calculation, switch to the timeseries endpoints for the same asset.

Timeseries

Query candles, open interest, and positioning series for a market.

Historical

Wallets

Inspect the wallets behind market positions and connect them to profile analytics.

Wallet drill-down

Rankings and activity

Use asset rankings and whale activity for market discovery surfaces.

Discovery

API Reference

Timeseries

Candles, open-interest series, and scanned-wallet positioning series in the DexHunt external API.

API Reference

Wallets

Wallet directory, wallet detail, profile analytics, open orders, fills, funding, and transfers in the DexHunt external API.

API Reference

Rankings and Activity

Overview, trader rankings, asset rankings, whale activity, and market news endpoints in the DexHunt external API.