# Hyperdash Data API > Hyperliquid data from Hyperdash's own nodes and stored datasets; requests never call Hyperliquid's public API. Auth: `Authorization: Bearer `. Base URL: https://data.hyperdash.com Errors are RFC 9457 problem+json with a stable `code` and a `hint`. 429 rate_limited (free; wait Retry-After): request rate, concurrent requests (a request counts one slot per 1,000 rows it can return: limit=5000 uses 5), or a server busy with your workspace's requests. Large pages are fine; send them a few at a time. ## MCP Remote MCP server (Streamable HTTP): https://data.hyperdash.com/mcp — one tool per endpoint below, plus `time_window` (local days, ranges and clock times in an IANA time zone → start_time / end_time; result timestamps → local time). Results that name accounts carry `hyperdash_links` (address → https://hyperdash.com/address/
). `give_feedback` sends the Hyperdash team a report: a tool that looks broken, data that looks wrong or missing, confusing output, or something no tool offers (no secrets or personal details). Connect with OAuth (claude.ai / ChatGPT custom connectors: discovery via /.well-known/oauth-protected-resource; you approve the project and scopes in the console) or send an API key as `Authorization: Bearer hdk_sk_…`. ## Candles (OHLCV) (beta) OHLCV candles per market from 1 minute to 1 month, built from Hyperdash's own nodes. Coverage from 2025-03-22. Closed minutes, available seconds after the minute ends (the last 30 min come from the live node window). - `GET /v1/markets/{coin}/candles` — Candles for one market (1m … 1M). Max range 7 d, max limit 5000. Scope `markets:read`. ## Account fills (beta) Every fill of one wallet (perps, spot, HIP-3), from Hyperdash's fill history. Coverage from 2025-03-22. Seconds behind the chain (node-live ingestion). - `GET /v1/accounts/{address}/fills` — Fills of one wallet. Max range 7 d, max limit 1000. Scope `accounts:read`. ## Live positions (beta) A wallet's open perp positions and margin right now, from Hyperdash's own nodes. Coverage from live. Live: the node state at meta.as_of (usually < 1 s old). - `GET /v1/accounts/{address}/positions` — Open positions of one wallet on one dex. Max range n/a, max limit 500. Scope `accounts:read`. ## Markets (live) (beta) Every perp market (core exchange and HIP-3 builder dexs) with live mark, oracle and mid prices, funding, open interest and 24 h volume; mids; spot markets; builder dexs. Coverage from live. Live node state (seconds). - `GET /v1/markets` — Perp markets with live context. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/markets/{coin}/twaps` — Active TWAPs of one market. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/spot/{token}/twaps` — Active TWAPs of one spot token. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/twap-levels` — TWAP stop and trigger levels of one market. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/spot/{token}/twap-levels` — TWAP stop and trigger levels of one spot token. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/markets/twap-pressure/active` — Net pressure of the TWAPs running now. Max range n/a, max limit 500. Scope `markets:read`. - `GET /v1/markets/{coin}/book/orders` — Order-level (L4) book near the mid. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/markets/margin-tables` — Tiered margin tables. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/lending/reserves` — Borrow/lend reserves. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/network/deploy-auctions` — Perp and spot deploy gas auctions. Max range n/a, max limit 3. Scope `markets:read`. - `GET /v1/markets/{coin}/book` — Order book snapshot (20 levels). Max range n/a, max limit 40. Scope `markets:read`. - `GET /v1/markets/mids` — Mid price of every market. Max range n/a, max limit 20000. Scope `markets:read`. - `GET /v1/spot/markets` — Spot markets with live context. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/spot/tokens` — Spot tokens. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/dexs` — HIP-3 builder dexs. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/dexs/{dex}/markets` — Per-market settings of one HIP-3 dex. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/markets/catalog` — Every market's category, sector and asset class. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/dexs/{dex}/limits` — A builder dex's open-interest and transfer limits. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/dexs/{dex}/status` — A builder dex's net deposits. Max range n/a, max limit 1. Scope `markets:read`. - `GET /v1/markets/max-market-order-notionals` — Largest market order per leverage tier. Max range n/a, max limit 50. Scope `markets:read`. - `GET /v1/network/exchange-status` — Exchange special statuses. Max range n/a, max limit 1. Scope `markets:read`. - `GET /v1/outcomes/definitions` — HIP-4 outcome and question definitions (live). Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/spot/tokens/{token_id}/supply` — Token supply (node state). Max range n/a, max limit 1. Scope `markets:read`. ## Account state (live) (beta) A wallet's live state from our nodes: margin summary and account equity (as hyperdash.com shows it), spot balances, open orders (incl. TP/SL triggers), active TWAPs, recent order history, TWAP fills, fee tier, sub-accounts and staking. Coverage from live. Live node state (seconds). - `GET /v1/accounts/{address}` — Margin summary and equity of one wallet. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/batch` — Account summaries of up to 25 wallets. Max range n/a, max limit 25. Scope `accounts:read`. - `POST /v1/accounts/batch` — Account summaries of many wallets. Max range n/a, max limit 10000. Scope `accounts:read`. - `GET /v1/accounts/batch/portfolio` — Portfolio summaries of up to 25 wallets. Max range n/a, max limit 25. Scope `accounts:read`. - `POST /v1/accounts/batch/portfolio` — Portfolio summaries of many wallets. Max range n/a, max limit 10000. Scope `accounts:read`. - `GET /v1/accounts/{address}/positions/all-dexes` — Margin summary on every dex. Max range n/a, max limit 100. Scope `accounts:read`. - `GET /v1/accounts/{address}/portfolio` — Consistent perp + spot portfolio. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/risk` — Live margin risk (accounts ≥ $100k). Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/markets/{coin}` — Leverage and tradable size in one market. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/{address}/agents` — Approved API agents. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/rate-limit` — Exchange request budget. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/{address}/vault-equities` — Vault deposits. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/builder-fee` — Approved max builder fee. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/{address}/spot-balances` — Spot balances of one wallet. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/open-orders` — Open orders of one wallet. Max range n/a, max limit 2000. Scope `accounts:read`. - `GET /v1/accounts/{address}/twaps` — Active TWAPs of one wallet. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/orders` — Recent order history of one wallet. Max range n/a, max limit 2000. Scope `accounts:read`. - `GET /v1/accounts/{address}/twap-fills` — TWAP slice fills of one wallet. Max range n/a, max limit 2000. Scope `accounts:read`. - `GET /v1/accounts/{address}/fees` — Fee tier of one wallet. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/{address}/subaccounts` — Sub-accounts of one wallet. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/staking` — HYPE staking of one wallet. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/orders/{oid}` — One order's status by oid or cloid. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/{address}/approved-builders` — Builder codes the wallet approved. Max range n/a, max limit 500. Scope `accounts:read`. - `GET /v1/accounts/{address}/multisig-signers` — A multi-sig account's signers and threshold. Max range n/a, max limit 100. Scope `accounts:read`. - `GET /v1/accounts/{address}/borrow-lend` — The wallet's borrow / lend positions and health. Max range n/a, max limit 200. Scope `accounts:read`. - `GET /v1/accounts/{address}/leading-vaults` — Vaults the wallet leads. Max range n/a, max limit 100. Scope `accounts:read`. ## Account history (beta) A wallet's non-funding ledger (deposits, withdrawals, transfers, spot/vault/staking moves, liquidation settlements), funding payments and completed round-trip trades with realized PnL — exact, from our nodes plus Hyperdash's history store. Coverage from 2023-02-26. Seconds behind the chain for the last 12 h (node), older from the history store. - `GET /v1/accounts/{address}/ledger` — Non-funding ledger updates of one wallet. Max range 30 d, max limit 2000. Scope `accounts:read`. - `GET /v1/accounts/{address}/funding` — Funding payments of one wallet. Max range 7 d, max limit 5000. Scope `accounts:read`. - `GET /v1/accounts/{address}/trades` — Completed round-trip trades of one wallet. Max range 90 d, max limit 500. Scope `accounts:read`. - `GET /v1/accounts/{address}/pnl-summary` — Lifetime PnL summary of one wallet. Max range n/a, max limit 1. Scope `accounts:read`. - `GET /v1/accounts/{address}/staking/history` — Staking history of one wallet. Max range 365 d, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/subaccounts/history` — Sub-accounts a wallet created. Max range 365 d, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/twaps/history` — TWAP history of one wallet. Max range 365 d, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/core-writer-actions` — HyperEVM ↔ Core actions of one wallet. Max range 365 d, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/actions` — L1 actions of one wallet. Max range 90 d, max limit 1000. Scope `accounts:read`. ## Market history (beta) Per-market history beyond candles: every trade (taker, maker, price, size), open interest, buy/sell volume and liquidation bars, mark/oracle/premium/predicted-funding bars, realized funding rates and volume footprints. Coverage from 2023-05-20. Trades: seconds (rows newer than ~60 s may still be completed). Trade bars and footprint: live to the current minute (~1 s; settled history below the certified frontier, meta.settled_to). Other bars and funding: loaded hourly — complete through the last closed hour, ~1–10 min after it closes (/v1/status shows the frontier). - `GET /v1/markets/{coin}/trades` — Trade tape of one market. Max range 1 d, max limit 1000. Scope `markets:read`. - `GET /v1/markets/{coin}/open-interest` — Open interest bars of one market. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/markets/{coin}/trade-bars` — Buy/sell volume and liquidation bars. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/markets/{coin}/context-history` — Mark, oracle, premium and predicted funding bars. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/markets/{coin}/funding-rates` — Realized funding rate history. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/markets/{coin}/footprint` — Volume footprint (volume at price per bar). Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/markets/{coin}/footprint/actions` — Position-action footprint (open / close × long / short × taker / maker per price row). Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/markets/{coin}/book/history` — Order book at a past minute. Max range n/a, max limit 40. Scope `markets:read`. - `GET /v1/markets/{coin}/twaps/history` — TWAP history of one market. Max range 30 d, max limit 1000. Scope `analytics:read`. - `GET /v1/markets/{coin}/oracle` — HIP-3 oracle bars. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/markets/{coin}/oracle/updates` — HIP-3 oracle updates. Max range 1 d, max limit 1000. Scope `markets:read`. - `GET /v1/network/evm-core-transfers` — HyperEVM ↔ Core actions of one type. Max range 7 d, max limit 1000. Scope `analytics:read`. - `GET /v1/network/deploys` — HIP-3 / spot / outcome deploy actions. Max range 365 d, max limit 1000. Scope `analytics:read`. ## Liquidations (beta) Every liquidation (market and backstop) with the liquidated wallet, side, price, size, notional, realized PnL and mark. Coverage from 2025-07-28. Seconds (events newer than ~60 s may still be completed). - `GET /v1/liquidations` — Liquidation events. Max range 7 d, max limit 2000. Scope `liquidations:read`. ## Analytics (beta) Hyperdash analytics: PnL leaderboards, exchange-wide long/short positioning, HIP-4 outcome markets and priority-fee spend. Coverage from 2025-03-22. Leaderboards rebuild every 5–15 min; positioning hourly; outcomes every 5 min. - `GET /v1/leaderboards/pnl` — PnL leaderboard. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/markets/positioning` — Long/short positioning history. Max range n/a, max limit 5000. Scope `analytics:read`. - `GET /v1/outcomes` — HIP-4 outcome market activity. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/outcomes/markets` — HIP-4 outcome markets. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/outcomes/{outcome}/probability` — Outcome probability history. Max range n/a, max limit 5000. Scope `analytics:read`. - `GET /v1/network/priority-fees` — Priority fee spend. Max range 365 d, max limit 5000. Scope `analytics:read`. ## Account value history (beta) A wallet's account value over time: hourly snapshots, daily close with daily PnL, and the cumulative PnL chart (account value change net of USDC flows). Coverage from 2025-07-29. Hourly snapshots ~minutes after the hour; daily rows after the UTC day closes. - `GET /v1/accounts/{address}/account-value` — Hourly account value. Max range 365 d, max limit 2500. Scope `accounts:read`. - `GET /v1/accounts/{address}/pnl-chart` — PnL chart. Max range n/a, max limit 1000. Scope `accounts:read`. - `GET /v1/accounts/{address}/portfolio-daily` — Daily account value and PnL. Max range 365 d, max limit 400. Scope `accounts:read`. ## Market positions (live) (beta) Every open position of a market (largest first, filterable), and where liquidations and stop orders sit: notional by price level. Coverage from live. Re-computed every few seconds from Hyperdash's nodes (meta.computed_at). - `GET /v1/markets/{coin}/positions` — Open positions of one market. Max range n/a, max limit 1000. Scope `markets:read`. - `GET /v1/markets/{coin}/liquidation-levels` — Liquidation levels (liq map). Max range n/a, max limit 100000. Scope `markets:read`. - `GET /v1/markets/{coin}/stop-levels` — Stop-order levels. Max range n/a, max limit 100000. Scope `markets:read`. - `GET /v1/accounts/liquidation-risk` — Large accounts by the BTC move that liquidates them. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/accounts/liquidation-risk/ladder` — Accounts liquidated per 1 % BTC move. Max range n/a, max limit 100. Scope `analytics:read`. ## Liquidation and stop-order analytics (beta) Where liquidations and stop orders sit (price-band heatmaps and totals), realized liquidations per market, the largest liquidation days, and stop-loss / take-profit density near the mark across every market. Coverage from 2025-07-28. Heatmaps and totals: latest positions snapshot (minutes). Realized liquidations: seconds. Stop summary: cached up to 5 min. - `GET /v1/markets/{coin}/liquidation-heatmap` — Liquidation-price heatmap of one market. Max range n/a, max limit 6. Scope `markets:read`. - `GET /v1/markets/{coin}/stop-heatmap` — Stop-order heatmap of one market. Max range n/a, max limit 6. Scope `markets:read`. - `GET /v1/markets/{coin}/liquidation-levels/totals` — Liquidation-level totals of one market. Max range n/a, max limit 1. Scope `markets:read`. - `GET /v1/markets/{coin}/stop-levels/totals` — Stop-order totals of one market. Max range n/a, max limit 1. Scope `markets:read`. - `GET /v1/markets/stop-summary` — Stop-loss / take-profit density, every market. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/liquidations/by-market` — Realized liquidations per market. Max range n/a, max limit 500. Scope `liquidations:read`. - `GET /v1/liquidations/cascades` — Largest liquidation days. Max range n/a, max limit 100. Scope `liquidations:read`. ## Cohorts and positioning (beta) How traders are positioned: top-trader consensus and fresh opens, net trader positioning (vaults excluded) per market and exchange-wide, and position counts. Coverage from 2025-03-22. Positioning snapshots about every 12 min: net positioning and position counts read the latest complete one, top-trader consensus the one before it; consensus and net positioning cached up to 5 min. - `GET /v1/cohorts/consensus` — Top-trader consensus per market. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/cohorts/opens` — Top-trader opens per market. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/markets/net-positioning` — Net trader positioning per market. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/markets/net-positioning/summary` — Net trader positioning, whole exchange. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/cohorts/positioning` — Hourly positioning by trader cohort. Max range n/a, max limit 20000. Scope `analytics:read`. - `GET /v1/cohorts/positioning/markets` — Cohort positioning of every market at one hour. Max range n/a, max limit 20000. Scope `analytics:read`. - `GET /v1/markets/{coin}/position-counts` — Position counts of one market. Max range n/a, max limit 1. Scope `markets:read`. - `GET /v1/markets/participation` — Holders, longs / shorts and profitable / losing per market. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/cohorts/totals` — Per account-size cohort: wallets, account value, uPnL, profitable / losing. Max range n/a, max limit 10. Scope `analytics:read`. ## Market structure (beta) Cumulative volume delta, funding screeners and matrices, open interest by category / dex / total and its changes, price changes and returns, beta to BTC, session returns, TWAP pressure, and trade.xyz equity session data. Coverage from 2025-03-22. Hourly rollups (current hour partial) unless stated; latest-value endpoints follow the market context feed (seconds to minutes). - `GET /v1/markets/{coin}/cvd` — Cumulative volume delta of one market. Max range n/a, max limit 2200. Scope `markets:read`. - `GET /v1/markets/funding/latest` — Funding screener. Max range n/a, max limit 100. Scope `markets:read`. - `GET /v1/markets/funding/matrix` — Funding matrix. Max range n/a, max limit 20000. Scope `markets:read`. - `GET /v1/markets/open-interest/changes` — Open interest changes, every market. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/markets/{coin}/open-interest/daily` — Daily open interest (USD) of one market. Max range n/a, max limit 400. Scope `markets:read`. - `GET /v1/markets/open-interest/by-category` — Open interest by asset category. Max range n/a, max limit 10000. Scope `markets:read`. - `GET /v1/markets/open-interest/by-dex` — Open interest by dex. Max range n/a, max limit 10000. Scope `markets:read`. - `GET /v1/markets/open-interest/total` — Open interest in USD over time. Max range n/a, max limit 10000. Scope `markets:read`. - `GET /v1/markets/price-changes` — Price changes, every market. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/markets/returns` — Returns matrix. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/markets/beta` — Beta and correlation to BTC. Max range n/a, max limit 5000. Scope `markets:read`. - `GET /v1/markets/session-returns` — Returns by trading session. Max range n/a, max limit 1500. Scope `markets:read`. - `GET /v1/markets/twap-pressure` — Net TWAP pressure per market. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/markets/{coin}/sentiment` — Sentiment regime inputs of one market. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/markets/{coin}/sentiment/events` — Unusual taker-flow hours of one market. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/markets/sentiment/scanner` — Sentiment scanner across markets. Max range 30 d, max limit 2000. Scope `analytics:read`. - `GET /v1/markets/{coin}/event-moves` — Price reaction around given times. Max range n/a, max limit 12. Scope `markets:read`. - `GET /v1/markets/{coin}/session-gaps` — Equity perp overnight gaps. Max range n/a, max limit 400. Scope `markets:read`. - `GET /v1/markets/{coin}/session-slots` — Equity perp 30-minute activity. Max range n/a, max limit 1500. Scope `markets:read`. - `GET /v1/markets/correlation` — Pairwise return correlation of 2–8 markets. Max range 365 d, max limit 28. Scope `analytics:read`. ## Exchange and ecosystem (beta) Exchange-level metrics: fee revenue, builder-dex volume share, new traders and wallet growth, trader profitability, HLP vault performance, HYPE staking and validators, HYPE supply and holder bands, Assistance Fund buybacks, USDC reserve, priority fees by market, and HIP-4 outcome activity. Coverage from 2025-03-22. Hourly or daily rollups (the current bucket is partial); validators hourly from our node's state (every 5 min from Hyperliquid until 2026-11-10 22:00 UTC); HYPE supply hourly; priority fees live (~10 s). - `GET /v1/network/builder-volume-share` — HIP-3 builder-dex volume share. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/network/revenue` — Trading-fee revenue. Max range n/a, max limit 2700. Scope `analytics:read`. - `GET /v1/network/new-traders` — New traders. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/user-growth` — Wallet growth. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/trader-profitability` — Trader profitability by account size. Max range n/a, max limit 400. Scope `analytics:read`. - `GET /v1/network/trader-distribution` — Active traders by account size, lifetime volume or size migration. Max range n/a, max limit 40. Scope `analytics:read`. - `GET /v1/network/hlp` — HLP vault performance. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/staking/flows` — HYPE staking flows. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/staking/validators` — Validator set. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/staking/history` — Total delegated HYPE over time. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/hype-supply` — HYPE supply. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/network/hype-holders` — HYPE holders by balance band. Max range n/a, max limit 400. Scope `analytics:read`. - `GET /v1/spot/tokens/{token}/holder-bands` — Spot token holders by balance band, now vs a week ago. Max range n/a, max limit 32. Scope `analytics:read`. - `GET /v1/lending/reserves/{token}/history` — Borrow/lend reserve history of one token. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/af-buybacks` — Assistance Fund buybacks. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/usdc-reserve` — USDC reserve balance. Max range n/a, max limit 5000. Scope `analytics:read`. - `GET /v1/network/usdc-reserve/settlements` — USDC reserve yield settlements. Max range n/a, max limit 5000. Scope `analytics:read`. - `GET /v1/network/priority-fees/summary` — Priority-fee totals. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/network/priority-fees/by-coin` — Priority fees per market. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/priority-fees/top-coins` — Priority fees of the top markets over time. Max range n/a, max limit 20000. Scope `analytics:read`. - `GET /v1/network/priority-fees/builder-share` — HIP-3 share of priority fees. Max range n/a, max limit 10000. Scope `analytics:read`. - `GET /v1/outcomes/activity` — HIP-4 outcome activity. Max range n/a, max limit 288. Scope `analytics:read`. - `GET /v1/staking/stakers/buckets` — Delegated HYPE by stake size. Max range n/a, max limit 10. Scope `analytics:read`. - `GET /v1/network/usdc-reserve/intervals` — USDC reserve yield per 30-day interval: accrual, settlement, implied rate. Max range 365 d, max limit 40. Scope `analytics:read`. - `GET /v1/staking/rewards` — Validator rewards. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/network/gossip-auctions` — Gossip priority auctions. Max range 365 d, max limit 1000. Scope `analytics:read`. - `GET /v1/staking/validators/registry` — Validator registry (node state). Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/referrals` — Referral code. Max range n/a, max limit 10. Scope `analytics:read`. ## Wallet analytics (beta) One wallet at a time: its PnL-leaderboard row (rank, net / realized / unrealized PnL, ROI: hyperdash.com's profile PnL), completed-trade statistics (overall and per market), risk metrics (Sharpe, Sortino, drawdowns), a trading review by market / month / weekday / hour, highlight trades, a daily PnL calendar, copy score, order history with the fills of each order, unrealized-PnL rank, staked HYPE at a past time and HIP-4 outcome records. Coverage from 2025-03-22. Leaderboard row: the board's build (every 5–15 min). Completed trades and order history: minutes. Statistics: recomputed continuously from completed trades. Risk metrics and copy score: daily. - `GET /v1/accounts/{address}/stats` — Trading statistics of one wallet. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/completed-trades` — Completed trades of one wallet: whole history, filters and sorts (hyperdash.com's Completed Trades tab). Max range n/a, max limit 200. Scope `analytics:read`. - `GET /v1/accounts/{address}/stats/by-market` — Trading statistics per market. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/accounts/{address}/trade-counts` — Trade and win counts over 7–365 days. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/risk-metrics` — Sharpe, Sortino and drawdowns. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/sharpe` — Sharpe and Sortino over a date range. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/review` — Trading review by market, month, weekday and hour. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/accounts/{address}/highlights` — Best, biggest, winning and losing trades. Max range n/a, max limit 30. Scope `analytics:read`. - `GET /v1/accounts/{address}/markets-traded` — Per-market performance over a window. Max range n/a, max limit 200. Scope `analytics:read`. - `GET /v1/accounts/{address}/pnl-calendar` — Daily PnL calendar. Max range n/a, max limit 400. Scope `analytics:read`. - `GET /v1/accounts/{address}/builders` — Builder fees a wallet paid, per builder code. Max range 365 d, max limit 500. Scope `analytics:read`. - `GET /v1/accounts/{address}/copy-score` — Copy score and its factors. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/year-summary` — Year in review: trader class and percentiles. Max range n/a, max limit 20. Scope `analytics:read`. - `GET /v1/accounts/{address}/window-stats` — Completed-trade PnL over 24 h / 7 d / 30 d / 90 d / YTD / all time. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/upnl-rank` — Rank by unrealized PnL. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/leaderboard` — The wallet's PnL leaderboard row (rank, net / realized / unrealized PnL, ROI). Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/staked-hype` — Delegated HYPE at a past time. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/accounts/{address}/order-fills` — Order history with each order's fills. Max range 1 d, max limit 99. Scope `accounts:read`. - `GET /v1/accounts/{address}/outcomes` — HIP-4 outcome record per market. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/accounts/{address}/copy-activity` — Daily copy-cost inputs. Max range n/a, max limit 365. Scope `analytics:read`. - `GET /v1/accounts/{address}/realized-pnl` — Realized PnL series. Max range 365 d, max limit 2200. Scope `analytics:read`. - `GET /v1/accounts/profiles` — Public profiles of up to 100 wallets. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/accounts/batch/stats` — Trader stats of up to 100 wallets. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/vaults/{vault}/history` — One vault over time. Max range 90 d, max limit 2400. Scope `analytics:read`. ## Exact market series (beta) Exact per-bucket market totals over any window: liquidations by side, funding paid and received by side, exchange fees and volume by segment or market, active traders, bridge flows, realized volatility, and window open/high/low/close per market. Coverage from 2023-03-30. Minutes (each series' completeness watermark; meta.as_of). Volatility: last complete hour. - `GET /v1/liquidations/series` — Exact liquidations per bucket and side. Max range n/a, max limit 6000. Scope `markets:read`. - `GET /v1/markets/funding/flows` — Funding paid and received by side. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/cohorts/flows` — Taker flows by account-size cohort. Max range n/a, max limit 10000. Scope `analytics:read`. - `GET /v1/network/fees` — Exchange fees and volume. Max range n/a, max limit 10000. Scope `markets:read`. - `GET /v1/network/active-traders` — Exact active traders. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/network/bridge-flows` — Bridge deposits and withdrawals. Max range n/a, max limit 4000. Scope `markets:read`. - `GET /v1/markets/{coin}/volatility` — Realized volatility of one market. Max range n/a, max limit 2000. Scope `markets:read`. - `GET /v1/markets/window-prices` — Exact open/high/low/close over a window. Max range n/a, max limit 10000. Scope `markets:read`. ## Wallet lists (beta) Ranked wallet lists: largest positions and liquidation / stop levels, positions near liquidation, new wallets with large positions, top and fastest-moving unrealized PnL, per-market and sorted leaderboards, largest liquidations, opens, whale deposits, the wallets behind one bar or price box, priority-fee payers, top stakers, and HIP-4 outcome leaderboards, holders and whale trades. At most 100 rows per list; lists count against your plan's wallet-discovery allowance. Coverage from live. Positions and levels: latest positions snapshot (minutes); live server lists: seconds. Heavy lists are cached up to 1–5 min (meta notes it). - `GET /v1/markets/{coin}/liquidation-levels/top` — Largest positions by liquidation price. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/stop-levels/top` — Largest resting stop orders. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/stop-orders` — Largest stop orders, live. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/position-changes` — Who just changed a position. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/liquidations/top` — Largest liquidations. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/positions/near-liquidation` — Positions closest to liquidation. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/positions/largest` — Largest open positions. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/positions/fresh-wallets` — New wallets with large positions. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/cohorts/top-positions` — Profitable traders' freshest winners. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/traders/top-unrealized` — Top traders by unrealized PnL. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/traders/unrealized-movers` — Biggest unrealized PnL moves. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/traders/groups/{group}` — hyperdash.com's copytrading groups. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/leaderboard` — Per-market PnL leaderboard. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/funding/top-wallets` — Top funding payers / earners of one market. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/leaderboards/sorted` — Completed-trade leaderboard by PnL, volume, trades, win rate or fees. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/largest-opens` — Largest position-opening orders. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/network/whale-deposits` — Large USDC deposits. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/network/priority-fees/top-users` — Largest priority-fee payers. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/staking/top-stakers` — Largest HYPE stakers. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/bar-flows` — Top buyers and sellers of one bar. Max range n/a, max limit 40. Scope `analytics:read`. - `GET /v1/markets/{coin}/box-traders` — Wallets that traded inside a price × time box. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/outcomes/leaderboard` — HIP-4 outcome PnL leaderboard. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/outcomes/whale-trades` — Large HIP-4 outcome trades. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/outcomes/{outcome}/holders` — Largest holders of one outcome. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/accounts/search` — Find wallets by profile name, label or X handle. Max range n/a, max limit 25. Scope `analytics:read`. - `GET /v1/markets/{coin}/leaderboard/asset-score` — One market's traders ranked by asset score. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/positions/top-unrealized` — Open positions with the largest unrealized PnL. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/stop-orders/history` — Wallets behind a market's stop orders at a past hour. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/staking/stakers/changes` — Largest changes in delegated HYPE between two times. Max range 90 d, max limit 100. Scope `analytics:read`. - `GET /v1/cohorts/{cohort}/members` — The positioned wallets of one account-size cohort. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/twaps` — Every running core-exchange perp TWAP. Max range n/a, max limit 500. Scope `analytics:read`. - `GET /v1/staking/validators/{validator}/delegations` — Delegations to one validator. Max range 90 d, max limit 100. Scope `analytics:read`. ## Full snapshots (beta) Every row of a live dataset, page by page: all open positions of a market, all holders of a spot token, all account values, all accounts with a position, all borrowers, all portfolio-margin accounts and all resting trigger orders of a market. Each read pins one consistent snapshot. Copying is bounded by your plan's snapshot allowances (rows per day / 30 days and wallets discovered per 30 days). Coverage from live. Positions and trigger orders: rebuilt at most every 30 s; accounts, borrowers: 60 s; spot holders and account values: the node's periodic state snapshot (minutes). meta.generation / meta.snapshot_id say which. - `GET /v1/snapshots/positions/{coin}` — Every open position in a market. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/snapshots/spot-holders/{token}` — Every holder of a spot token. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/snapshots/account-values` — Every account's value. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/snapshots/positioned-accounts` — Every account with an open perp. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/snapshots/portfolio-margin-accounts` — Every portfolio-margin account. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/snapshots/borrowers` — Every borrower. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/snapshots/trigger-orders/{coin}` — Every resting trigger order in a market. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/vaults` — Vaults. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/vaults/{vault}/followers` — Followers of one vault. Max range n/a, max limit 100. Scope `analytics:read`. ## Traders: screener, cohort, builders (beta) The trader screener (every ranked trader's PnL windows, win rates, Sharpe / Sortino, drawdowns, copy scores and profile, top 2,000 per sort), our curated cohort of profitable traders (algorithmic-tagged accounts left out), the members of a builder code, sub-builder earnings and fee splits, and the portfolio-PnL leaderboard (unrealized / total / % PnL). Lists count against your plan's snapshot allowances (rows and wallets). Coverage from 2025-03-22. Each wallet's trader stats are rebuilt about once a day (every 24–26 h, at a wallet-specific time; `updated_at` per row); these reads are cached up to 10 min (60 min for the cohort). - `GET /v1/traders/screener` — Trader screener. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/traders/cohort` — Curated profitable trader cohort. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/builders/{builder}/members` — Wallets of a builder code. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/builders/sub-builders` — Sub-builder earnings. Max range 30 d, max limit 500. Scope `analytics:read`. - `GET /v1/builders/{builder}/sub-builders` — How a builder shares its fees. Max range 30 d, max limit 500. Scope `analytics:read`. - `GET /v1/leaderboards/portfolio` — Portfolio-PnL leaderboard. Max range n/a, max limit 100. Scope `analytics:read`. ## Position books and footprint wallets (beta) A market's position book at any time in the last 7 days (long / short totals and the largest positions then, whether each is still open or was liquidated since), and every wallet behind one footprint bar (size, notional, fills, taker part per side). Coverage from 2026-10-19. Position books: the positions snapshot nearest the requested time (minutes). Footprint wallets: per minute, settled within the hour. - `GET /v1/markets/{coin}/position-book` — Position book at a past time. Max range n/a, max limit 100. Scope `analytics:read`. - `GET /v1/markets/{coin}/footprint/all-wallets` — Every wallet behind a footprint bar. Max range 1 d, max limit 1000. Scope `analytics:read`. ## Wallet history extras (beta) A wallet's perp positions at chosen times (from our periodic position snapshots), its 90-day daily perp PnL, and the newest completed trades of up to 25 wallets at once. Coverage from 2025-03-22. Position snapshots every ~10 min (last 30 days); PnL daily; batch recent trades as Hyperdash last refreshed each wallet (minutes to a few hours after the close, longer for wallets that stopped trading). - `GET /v1/accounts/{address}/position-history` — Positions at chosen times. Max range n/a, max limit 200. Scope `accounts:read`. - `GET /v1/accounts/{address}/pnl-history` — Daily perp PnL, last 90 days. Max range n/a, max limit 100. Scope `accounts:read`. - `GET /v1/accounts/batch/recent-trades` — Newest completed trades of many wallets. Max range n/a, max limit 1250. Scope `accounts:read`. ## More market and network data (beta) Trader-class aggregates per year, every perp market's trading totals (volume / trades / traders over Hyperdash's fill record, partial before 2025-05-26), the profitable share per account-size cohort over a window, per-minute and per-coin liquidations over a window, Deribit options implied volatility, perp venue market share and daily spot ETF flows. Coverage from 2025-03-22. Aggregates refresh hourly or daily; liquidations within seconds; third-party series as their sources publish. - `GET /v1/network/trader-classes/{trader_class}` — Trader-class aggregates for a year. Max range n/a, max limit 1. Scope `analytics:read`. - `GET /v1/markets/traded-assets` — Every perp market's trading totals. Max range n/a, max limit 1000. Scope `analytics:read`. - `GET /v1/network/trader-profitability/window` — Profitable share per cohort over a window. Max range 30 d, max limit 20. Scope `analytics:read`. - `GET /v1/liquidations/minutes` — Liquidations per minute. Max range 1 d, max limit 1441. Scope `analytics:read`. - `GET /v1/liquidations/mix` — Liquidations per market over a window. Max range 1 d, max limit 2000. Scope `analytics:read`. - `GET /v1/markets/{coin}/options-iv` — Options implied volatility (Deribit). Max range 365 d, max limit 1000. Scope `analytics:read`. - `GET /v1/network/venue-share` — Perp venue market share (CoinGlass). Max range 365 d, max limit 5000. Scope `analytics:read`. - `GET /v1/network/etf-flows/{asset}` — Spot ETF flows. Max range n/a, max limit 10000. Scope `analytics:read`. ## Priority fees and queue (beta) Who paid to jump the order book queue on one market: every IOC fill that paid priority gas (HYPE burned), every resting ALO order bought with queue priority (rate p, fee in USD), which L4-book orders carry priority, and the ALO priority payers per bar. Every row carries a wallet: Growth plans and above. Coverage from 2026-04-13. IOC fills and ALO orders: live (~0.4 s behind the chain, from Hyperdash's workers); IOC fills older than ~1 h from the history store. ALO bars: minute rows land ~1 min after the minute (the last ~2 min provisional). - `GET /v1/markets/{coin}/priority-fills` — IOC fills that paid priority gas. Max range 0.041666666666666664 d, max limit 5000. Scope `analytics:read`. - `GET /v1/markets/{coin}/alo-priority` — Resting ALO orders that bought queue priority. Max range 0.006944444444444444 d, max limit 5000. Scope `analytics:read`. - `POST /v1/markets/{coin}/alo-priority/lookup` — Which orders paid for queue priority. Max range n/a, max limit 2000. Scope `analytics:read`. - `GET /v1/markets/{coin}/alo-priority/bars` — ALO priority payers per bar. Max range 7 d, max limit 5000. Scope `analytics:read`. ## Async jobs (Growth, Scale and Enterprise) POST /v1/jobs {kind, params} with an Idempotency-Key → poll GET /v1/jobs/{id} → read GET /v1/jobs/{id}/result (paged). - `account_fills_summary` — Per coin over up to 90 days for one wallet: fills, buy/sell notional, fees per fee token, realized PnL, first and last fill. Both legs of self-matches count. Scope `accounts:read`.