Position history
Chronological open/update/close position events for a wallet.
/networks/{network}/wallets/{address}/positions/historyA paginated log of a wallet's position open, update, and close events. Use asset to narrow to one market; use from/to (ISO 8601 or epoch ms) to bound the time window.
Network identifier. Only hyperliquid is supported.
Example: hyperliquid
Wallet address — 0x followed by 40 lowercase hex characters.
Example: 0x1111111111111111111111111111111111111111
Filter to a single asset by canonical symbol.
Example: BTC
Start of the time window — ISO 8601 instant or epoch milliseconds.
Example: 2026-06-01T00:00:00Z
End of the time window — ISO 8601 instant or epoch milliseconds.
Maximum results per page. Default 100, hard cap 500.
Example: 25
Responses
200OK
Chronological log of position open, update, and close events.
Network identifier.
Wallet the history belongs to.
Position events, newest first.
Event time in epoch milliseconds.
Event time as an instant.
Canonical asset symbol.
Network-specific asset symbol.
Position side — long or short.
Position notional in USD.
Liquidation price at the event.
Event type — opened_or_updated or closed.
400Bad Request
401Unauthorized
404Not Found
500Server Error
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/wallets/0x1111111111111111111111111111111111111111/positions/history?asset=BTC&limit=5" \
-H "X-API-Key: hlsk_your_developer_key"{
"network": "hyperliquid",
"walletAddress": "0x1111111111111111111111111111111111111111",
"items": [
{
"observedAtMs": 1749686400000,
"observedAt": "2026-06-12T00:00:00Z",
"canonicalAsset": "BTC",
"networkAssetSymbol": "BTC",
"side": "long",
"amountUsd": "3000000.00",
"liquidationPrice": "60350.5",
"eventType": "opened_or_updated"
}
]
}