Quickstart
Your first authenticated requests, end to end.
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.
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
Values are shortened for readability; field names match the server contract.
Representative JSON
Verify authentication
Use GET /networks to confirm that the token can reach the API and to discover available source networks.
curl -sS "https://api.dexhunt.app/v1/networks" \
-H "X-API-Key: hlsk_your_developer_key"{
"items": [
{
"network": "hyperliquid",
"displayName": "Hyperliquid",
"scanAssetCount": 250
}
],
"nextCursor": null
}List wallets
List wallets to discover traders. Responses include live account state plus nullable analytics from the latest wallet profile.
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/wallets?size=whale&direction=long&sort=accountTotalValue&limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"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.
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/markets?sort=openInterest&order=desc" \
-H "X-API-Key: hlsk_your_developer_key"{
"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.
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/markets/BTC/candles?interval=1h&limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"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"
}