Query positioning
Scanned-wallet long/short positioning timeseries with counts, notional, and ratio.
/networks/{network}/markets/{asset}/positioningPositioning 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.
Network identifier. Only hyperliquid is supported.
Example: hyperliquid
Canonical asset symbol or network symbol (e.g. BTC, ETH, xyz:SP500).
Example: BTC
Positioning interval. Supported: 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M.
Example: 1h
Start of the time window — ISO 8601 instant or epoch milliseconds.
Example: 2026-06-12T00:00:00Z
End of the time window — ISO 8601 instant or epoch milliseconds.
Maximum data points to return. Default 500, hard cap 5000.
Example: 500
Epoch-ms cursor from the previous page's nextCursor field.
Responses
200OK
Scanned-wallet long/short positioning timeseries.
Network identifier.
Network asset symbol.
Canonical asset symbol.
Aggregation interval used.
Positioning points, newest first.
Sample time in epoch milliseconds.
Sample time as an instant.
Scanned wallets positioned long.
Scanned wallets positioned short.
Long notional in USD.
Short notional in USD.
Ratio of long to short notional.
Long minus short notional in USD.
Epoch-ms cursor for the previous window, or null at the start of history.
400Bad Request
401Unauthorized
404Not Found
500Server Error
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/markets/BTC/positioning?interval=4h&limit=2" \
-H "X-API-Key: hlsk_your_developer_key"{
"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"
}