6 min read·Updated 2026-06-12

Quickstart

Use curl against api.dexhunt.app, verify your token, then fetch wallet, market, and candle data.

Prepare a token

Requires a developer token

Create a developer API token in the DexHunt account area before calling the API. API tokens use the hlsk_ prefix and are sent with X-API-Key.

Base URL

Use https://api.dexhunt.app as the host. The external API namespace is /api/developer/v1.

https://api.dexhunt.app/api/developer/v1

Network

All examples use the Hyperliquid network id in the path. Network ids are lowercase.

hyperliquid

Authentication

Pass a developer API token in every request. Missing or invalid keys return 401 problem details.

X-API-Key

Examples

Examples use shortened values where possible, but the JSON field names match the server contract.

Representative JSON

Verify authentication

Use GET /networks to confirm that the token can reach the external API and to discover available source networks.

Request

bash

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

Example response

json

{
  "items": [
    {
      "network": "hyperliquid",
      "displayName": "Hyperliquid",
      "active": true,
      "strategyEnabled": true,
      "scanAssetCount": 250
    }
  ],
  "nextCursor": null
}

List wallets

The wallet directory is the main entry point for trader discovery. The response includes live account state from scanned wallets plus nullable analytics from the latest wallet profile.

Request

bash

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

Example response

json

{
  "items": [
    {
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "tags": ["whale", "high_quality"],
      "kols": [],
      "kolProfile": null,
      "sizeClass": "whale",
      "direction": "long",
      "accountTotalValue": "12500000.42",
      "totalPositionValue": "4200000.00",
      "longValue": "4200000.00",
      "shortValue": "0",
      "leverage": "0.34",
      "positions": 3,
      "observedAt": "2026-06-12T12:00:00Z",
      "netPnl": "820000.12",
      "roi": "7.12",
      "winRate": "63.50",
      "strategy": "lowDd",
      "strategyConfidence": "0.82"
    }
  ],
  "nextCursor": "2",
  "total": 14,
  "coverage": "scanned_wallets"
}

List markets

Market endpoints combine exchange quote data with DexHunt scanned wallet aggregates. Use them to find active assets before pulling position or liquidation detail.

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"
}

Query timeseries

Timeseries endpoints require an interval. The from, to, and cursor values accept ISO instants or epoch milliseconds.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/markets/BTC/candles?interval=1h&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"
}

What to do next

Conventions

Read the rules that apply to all endpoints before wiring a production integration.

Required

Wallets

Open wallet detail, profile analytics, open orders, fills, funding, and transfers.

Data model

Endpoint catalog

Find every external path, accepted query params, and the detailed page for it.

Lookup

Start

API Conventions

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

API Reference

Wallets

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

API Reference

Markets

Market snapshots, market detail, scanned wallet positions, and liquidation-level aggregates in the DexHunt external API.