9 min read·Updated 2026-06-12

Timeseries

Historical candle, open-interest, and scanned-wallet positioning series with shared interval and cursor rules.

Use one query contract

Candles, open interest, and positioning share the same query contract. Each endpoint requires interval and accepts optional from, to, limit, and cursor. If from is omitted, the API returns the most recent window for the requested limit.

interval

Supported values are 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, and 1M.

required

time parameters

Use ISO instants or epoch milliseconds. Cursor values returned by the API are epoch milliseconds.

from / to / cursor

limit

Timeseries endpoints default to 500 points and cap at 5000 points.

500 / 5000

asset

Assets resolve by canonical asset or network symbol, including symbols that contain colon, underscore, or hyphen.

BTC or xyz:SP500

Query candles

Candle points include epoch-millisecond time, ISO openTime, OHLC strings, volume, and trade count.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC/candles?interval=1h&from=2026-06-12T00:00:00Z&to=2026-06-12T12:00:00Z&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "network": "hyperliquid",
  "coin": "BTC",
  "canonicalAsset": "BTC",
  "interval": "1h",
  "candles": [
    {
      "time": 1781262000000,
      "openTime": "2026-06-12T11:00:00Z",
      "open": "66820.0",
      "high": "67110.0",
      "low": "66740.5",
      "close": "67000.5",
      "volume": "1250.44",
      "trades": 18422
    }
  ],
  "nextCursor": "1781258400000"
}

Query open interest

Open-interest points are sampled from Hyperliquid market context and rolled up by interval. The closeUsd field is the notional open-interest value; mark and funding are carried with the sample.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC/open-interest?interval=1h&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "network": "hyperliquid",
  "coin": "BTC",
  "canonicalAsset": "BTC",
  "interval": "1h",
  "points": [
    {
      "time": 1781262000000,
      "openTime": "2026-06-12T11:00:00Z",
      "open": "905000000",
      "high": "914000000",
      "low": "900000000",
      "close": "910000000",
      "closeUsd": "910000000",
      "mark": "67000.5",
      "funding": "0.0000125"
    }
  ],
  "nextCursor": "1781258400000"
}

Query positioning

Positioning points aggregate DexHunt scanned-wallet positioning by asset and interval. Use these values for long-short ratios, notional imbalance, and changes in tracked wallet exposure.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC/positioning?interval=4h&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "network": "hyperliquid",
  "coin": "BTC",
  "canonicalAsset": "BTC",
  "interval": "4h",
  "points": [
    {
      "time": 1781251200000,
      "at": "2026-06-12T08:00:00Z",
      "longCount": 118,
      "shortCount": 94,
      "longNotionalUsd": "111386355",
      "shortNotionalUsd": "56587359",
      "longShortRatio": "1.2553",
      "positionValueDiffUsd": "54798996"
    }
  ],
  "nextCursor": "1781236800000"
}

Continue with cursors

All three endpoints page backward through time with the cursor returned by the storage layer. Do not compute the next cursor on the client; use the returned value unchanged.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC/candles?interval=1h&cursor=1781258400000&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "network": "hyperliquid",
  "coin": "BTC",
  "canonicalAsset": "BTC",
  "interval": "1h",
  "candles": [
    {
      "time": 1781254800000,
      "openTime": "2026-06-12T09:00:00Z",
      "open": "66680.0",
      "high": "66900.0",
      "low": "66510.5",
      "close": "66820.0",
      "volume": "990.11",
      "trades": 16102
    }
  ],
  "nextCursor": null
}

What to do next

Markets

Use market snapshots to choose assets and compare current quote, OI, funding, and liquidation totals.

Current state

Wallets

Use wallet endpoints to inspect the addresses behind positioning changes.

Drill down

Conventions

Review validation, pagination, and error rules shared by every timeseries endpoint.

Contract

Start

API Conventions

Shared DexHunt external API conventions for auth, decimal precision, coverage, pagination, validation, errors, and limits.

API Reference

Markets

Market snapshots, market detail, scanned wallet positions, and liquidation-level aggregates 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.