Positioning flow
Positioning timeseries with per-period wallet count and notional deltas.
/networks/{network}/markets/{asset}/positioning/flowPositioning flow adds per-period deltas to the snapshot positioning timeseries. Each point shows how many wallets opened or closed longs and shorts since the previous period, and the notional change. The first point always has null deltas. Flow is derived from adjacent positioning points at request time; it is not a separately stored series.
Network identifier. Only hyperliquid is supported.
Example: hyperliquid
Canonical asset symbol or network symbol (e.g. BTC, ETH, xyz:SP500).
Example: BTC
Aggregation interval. Supported: 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M.
Example: 1h
Start of the time window — ISO 8601 or epoch ms.
End of the time window — ISO 8601 or epoch ms.
Maximum points to return. Default 500, hard cap 5000.
Epoch-ms cursor from the previous page's nextCursor field.
Responses
200OK
Positioning timeseries with per-period wallet count and notional deltas.
Network identifier.
Canonical asset symbol.
Aggregation interval used.
Positioning points, oldest first.
Point time in epoch milliseconds.
Point time as an instant.
Wallets long at the point.
Wallets short at the point.
Long notional in USD at the point.
Short notional in USD at the point.
Change in long wallet count since the previous point; null on the first point.
Change in short wallet count since the previous point; null on the first point.
Change in long notional since the previous point.
Change in short notional since the previous point.
Cursor for the next page, or null at the end.
400Bad Request
401Unauthorized
404Not Found
500Server Error
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/markets/BTC/positioning/flow?interval=1h&limit=3" \
-H "X-API-Key: hlsk_your_developer_key"{
"network": "hyperliquid",
"canonicalAsset": "BTC",
"interval": "1h",
"items": [
{
"atMs": 1749679200000,
"at": "2026-06-11T22:00:00Z",
"longCount": 86,
"shortCount": 32,
"longNotionalUsd": "140000000.00",
"shortNotionalUsd": "37000000.00",
"longDelta": null,
"shortDelta": null
},
{
"atMs": 1749682800000,
"at": "2026-06-11T23:00:00Z",
"longCount": 88,
"shortCount": 30,
"longDelta": 2,
"shortDelta": -2,
"longNotionalDeltaUsd": "2000000.00",
"shortNotionalDeltaUsd": "1000000.00"
}
],
"nextCursor": null
}