DatasetsHyperliquid
Position snapshots
Open Hyperliquid positions captured every 5 minutes — the latest snapshot, or history by window.
Open Hyperliquid positions captured every 5 minutes — the latest snapshot, or history by window.
Coverage and cadence
Cadence. Snapshot every 5 minutes
Latest open positions (freshness-gated to the newest 15 minutes of snapshots) or historical 5-minute snapshots: pass start (and optionally end), and bound the read by coin or wallet. Every row says which pnl-cohort label it carries (pnl_cohort_basis). Keyset pagination: nextCursor back as cursor, limit up to 5,000.
Fields
| Field | Type | Description |
|---|---|---|
wallet | string | Account address, 0x-prefixed |
asset | string | Coin; HIP-3 DEX coins carry their DEX prefix, e.g. xyz:SILVER |
direction | string | long | short |
size_token | number | Position size in coin units |
size_usd | number | Notional at mark, USD |
entry_price | number | Average entry price |
mark_price | number | Mark price at the snapshot |
liquidation_price | number | Liquidation price as reported; 0.0 when none is reported |
unrealized_pnl | number | Mark-to-market PnL, USD |
leverage | number | Position leverage as reported |
leverage_type | string | cross | isolated |
margin_used | number | Margin backing the position, USD |
size_cohort | string | Account-value rung, e.g. whale (size ladder) |
pnl_cohort | string | Realized-PnL percentile rung, or unknown under 10 closed trades |
pnl_abs_cohort | string | Realized-PnL dollar band, e.g. -$10k-$0 |
liq_progress | number | How far price has moved toward liquidation (0 = none); > 0.5 counts as at risk |
dex_name | string | HL, or the HIP-3 DEX the position is on |
snapshot_ts | string | Snapshot instant, ISO-8601 UTC |
pnl_cohort_basis | string | point_in_time | current — which label the row carries |
pnl_cohort_as_of | string|null | Hour the point-in-time label was computed at; null for current |
opened_at | string|null | When the position was first seen open, ISO-8601 UTC; null when unknown |
How to get it
Sample call
The call the dataset explorer builds:
curl -s "https://data.vike.io/v1/hyperliquid/positions?coin=BTC&limit=10" \
-H "X-API-KEY: $VIKE_API_KEY"