--- title: "Hyperliquid REST API | 0xArchive Docs" description: "Use Hyperliquid REST routes for order books, trades, candles, funding, open interest, liquidations, order flow, and freshness." canonical_url: "https://www.0xarchive.io/docs/rest-api/hyperliquid/" markdown_url: "https://www.0xarchive.io/docs/rest-api/hyperliquid.md" route: "/docs/rest-api/hyperliquid" robots: "index, follow" generated_from: "prerendered_html" --- # Hyperliquid REST API Hyperliquid REST routes for order books, trades, candles, funding, open interest, liquidations, order flow, freshness, credits, and example requests. 37 documented routes. Routes 37 documented routes Coverage Core perp markets Includes Candles, liquidations, order flow [OpenAPI Spec](https://www.0xarchive.io/openapi.json) ## Hyperliquid Core perp routes for market state, history, order flow, liquidations, and monitoring. ### Hyperliquid - Order Book GET `/v1/hyperliquid/orderbook/:symbol` Copy 1 credit Get current order book or snapshot at specific timestamp Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `timestamp` query Unix timestamp in ms for historical snapshot `depth` query Number of price levels per side. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth Request ``` /v1/hyperliquid/orderbook/BTC?timestamp=1704067200000&depth=20 ``` Response ``` { "success": true, "data": { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50", "spread_bps": "1.19" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/orderbook/:symbol/history` Copy 5 credit s Get historical order book snapshots with pagination. Get historical order book snapshots with pagination. Returns sub-second L1 snapshots (~1.2s native cadence) — for tick-level order changes use /orderbook/:symbol/l4/diffs (Pro+) or /orderbook/:symbol/l2/diffs. Data available from April 2023. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) `depth` query Number of price levels per side. Tier limits: Free=20, Build=200, Pro=Full Depth, Enterprise=Full Depth Request ``` /v1/hyperliquid/orderbook/BTC/history?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid - Trades GET `/v1/hyperliquid/trades/:symbol` Copy 2 credit s Get trade history with cursor pagination. Get trade history with cursor pagination. Data available from April 2023 (pre-March 2025 fills are taker-only). Use next_cursor from response to fetch subsequent pages. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (next_cursor) `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/trades/ETH?start=1704067200000&end=1704153600000&limit=1000 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "side": "B", "price": "42150.50", "size": "0.25", "trade_id": 12345678, "direction": "Open Long" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid - Market Data GET `/v1/hyperliquid/instruments` Copy 1 credit List all available Hyperliquid trading instruments Request ``` /v1/hyperliquid/instruments ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "exchange": "hyperliquid", "quote": "USDC", "active": true }, { "symbol": "ETH", "exchange": "hyperliquid", "quote": "USDC", "active": true } ], "meta": { "request_id": "req_abc123", "count": 2 } } ``` GET `/v1/hyperliquid/instruments/:symbol` Copy 1 credit Get a single Hyperliquid instrument by symbol, including the latest venue metadata and trading state. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) Request ``` /v1/hyperliquid/instruments/BTC ``` Response ``` { "success": true, "data": { "symbol": "BTC", "exchange": "hyperliquid", "base": "BTC", "quote": "USDC", "active": true, "tick_size": "0.5", "lot_size": "0.001" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/openinterest/:symbol` Copy 2 credit s Get historical open interest data with market context. Get historical open interest data with market context. Data available from May 2023. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (next_cursor) `limit` query Max results (default: 100, max: 1000) `interval` query Aggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw ~1 min data. Request ``` /v1/hyperliquid/openinterest/BTC?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "open_interest": "12500.5", "mark_price": "42150.75" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/openinterest/:symbol/current` Copy 1 credit Get current open interest for a symbol Parameters `symbol` path required Trading pair (e.g., BTC, ETH) Request ``` /v1/hyperliquid/openinterest/BTC/current ``` Response ``` { "success": true, "data": { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "open_interest": "12500.5", "mark_price": "42150.75" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/funding/:symbol` Copy 2 credit s Get historical funding rates. Get historical funding rates. Data available from May 2023. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (next_cursor) `limit` query Max results (default: 100, max: 1000) `interval` query Aggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw ~1 min data. Request ``` /v1/hyperliquid/funding/BTC?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "funding_rate": "0.0001", "premium": "0.00005" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/funding/:symbol/current` Copy 1 credit Get current funding rate for a symbol Parameters `symbol` path required Trading pair (e.g., BTC, ETH) Request ``` /v1/hyperliquid/funding/BTC/current ``` Response ``` { "success": true, "data": { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "funding_rate": "0.0001", "premium": "0.00005" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/liquidations/:symbol` Copy 3 credit s Get liquidation events for a symbol. Get liquidation events for a symbol. Data available from December 2025+. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Cursor from previous response (format: timestamp_tradeId) `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/liquidations/BTC?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "liquidated_user": "0x1234...abcd", "side": "B", "price": "42150.50", "size": "1.5", "direction": "Close Long" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/liquidations/user/:user` Copy 3 credit s Get liquidation events for a user address. Get liquidation events for a user address. Returns liquidations where the user was liquidated. Data available from December 2025. Parameters `user` path required User wallet address (e.g., 0x...) `start` query required Start timestamp in ms `end` query required End timestamp in ms `symbol` query Optional symbol filter (e.g., BTC) `cursor` query Cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/liquidations/user/0x84eec0068b37919cc8f13d7454073ac167374cc0?start=1704067200000&end=1704153600000 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "liquidated_user": "0x1234...abcd", "side": "B", "price": "42150.50", "size": "1.5", "direction": "Close Long" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/liquidations/:symbol/volume` Copy 3 credit s Get pre-aggregated liquidation volumes in time-bucketed intervals. Get pre-aggregated liquidation volumes in time-bucketed intervals. Returns total, long, and short USD liquidation volumes with counts. Much more efficient than fetching individual liquidation records. Data available from December 2025+. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query Start timestamp (Unix ms or ISO 8601). Defaults to 24h ago. `end` query End timestamp (Unix ms or ISO 8601). Defaults to now. `interval` query Aggregation interval: 5m, 15m, 30m, 1h (default), 4h, 1d `limit` query Max results (default: 100, max: 1000) `cursor` query Pagination cursor from previous response Request ``` /v1/hyperliquid/liquidations/BTC/volume?start=1704067200000&end=1704153600000&interval=1h&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "interval": "1h", "long_volume": "125000.50", "short_volume": "98000.25", "count": 14 } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/freshness/:symbol` Copy 1 credit Check when data was last updated for each data type for a specific symbol. Check when data was last updated for each data type for a specific symbol. Useful for agents and automated systems to verify data currency before pulling large datasets. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) Request ``` /v1/hyperliquid/freshness/BTC ``` Response ``` { "success": true, "data": { "symbol": "BTC", "exchange": "hyperliquid", "latest_timestamp": "2026-01-01T12:00:00Z", "lag_ms": 1200, "status": "fresh" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/summary/:symbol` Copy 2 credit s Get a combined market summary for a symbol in a single API call. Get a combined market summary for a symbol in a single API call. Returns latest price, funding rate, open interest, 24h volume, and 24h liquidation volumes — replacing what would otherwise require 4-5 separate API calls. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) Request ``` /v1/hyperliquid/summary/BTC ``` Response ``` { "success": true, "data": { "symbol": "BTC", "mark_price": "42150.75", "mid_price": "42150.75", "open_interest": "12500.5", "volume_24h": "1250000000", "timestamp": "2026-01-01T12:00:00Z" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/prices/:symbol` Copy 2 credit s Get mark and oracle price history for a symbol. Get mark and oracle price history for a symbol. This route returns price fields only and supports time aggregation intervals. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query Start timestamp (Unix ms or ISO 8601). Defaults to 24h ago. `end` query End timestamp (Unix ms or ISO 8601). Defaults to now. `interval` query Aggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw data. `limit` query Max results (default: 100, max: 1000) `cursor` query Pagination cursor from previous response Request ``` /v1/hyperliquid/prices/BTC?start=1704067200000&end=1704153600000&interval=1h&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "mark_price": "42150.75", "oracle_price": "42148.50", "mid_price": "42150.75" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid - Candles GET `/v1/hyperliquid/candles/:symbol` Copy 3 credit s Get OHLCV candle data aggregated from trades. Get OHLCV candle data aggregated from trades. Data available from March 2025. Supports cursor pagination for large datasets. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `interval` query Candle interval: 1m, 5m, 15m, 30m, 1h (default), 4h, 1d, 1w `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/candles/BTC?start=1704067200000&end=1704153600000&interval=1h&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "interval": "1h", "open": "42100.00", "high": "42200.00", "low": "42050.00", "close": "42180.00", "volume": "125.5" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid - L4 Order Book (Node-Level) GET `/v1/hyperliquid/orders/:symbol/history` Copy 5 credit s Get order history with user attribution from Hyperliquid node data. Get order history with user attribution from Hyperliquid node data. Includes order placements, cancellations, and fills. Requires Pro tier or higher. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `user` query Filter by user wallet address (e.g., 0x...) `status` query Filter by order status (e.g., open, filled, cancelled) `order_type` query Filter by order type (e.g., limit, market) `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orders/BTC/history?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "order_id": "0xabc", "user_address": "0x1234...abcd", "status": "filled", "side": "B", "price": "42150.50", "size": "1.2" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/orders/:symbol/flow` Copy 5 credit s Get aggregated order flow data showing buy/sell pressure over time intervals. Get aggregated order flow data showing buy/sell pressure over time intervals. Useful for analyzing market microstructure. Requires Pro tier or higher. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `interval` query Aggregation interval (e.g., 1m, 5m, 15m, 1h) `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orders/BTC/flow?start=1704067200000&end=1704153600000&interval=5m&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "interval": "5m", "new_orders": 1250, "cancels": 1180, "fills": 340, "net_size": "42.5" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/orders/:symbol/tpsl` Copy 5 credit s Get take-profit and stop-loss order history with user attribution. Get take-profit and stop-loss order history with user attribution. Shows triggered and untriggered TP/SL orders. Requires Pro tier or higher. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `user` query Filter by user wallet address (e.g., 0x...) `triggered` query Filter by triggered status (true/false) `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orders/BTC/tpsl?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "order_id": "0xabc", "trigger_price": "42000.00", "order_type": "stop_market", "side": "A", "size": "0.5" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/orderbook/:symbol/l4` Copy 10 credit s Reconstruct the L4 orderbook at a specific point in time, showing individual orders with user attribution at each price level. Reconstruct the L4 orderbook at a specific point in time, showing individual orders with user attribution at each price level. Requires Pro tier or higher. Data available from March 11, 2026. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `timestamp` query required Unix timestamp in ms for reconstruction point `depth` query Number of price levels per side (default: 20) Request ``` /v1/hyperliquid/orderbook/BTC/l4?timestamp=1704067200000&depth=20 ``` Response ``` { "success": true, "data": { "symbol": "BTC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/orderbook/:symbol/l4/diffs` Copy 5 credit s Get L4 orderbook diffs showing individual order changes with user attribution. Get L4 orderbook diffs showing individual order changes with user attribution. Each diff represents an order placement, cancellation, or fill. Requires Pro tier or higher. Data available from March 10, 2026. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orderbook/BTC/l4/diffs?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/orderbook/:symbol/l4/history` Copy 10 credit s Get L4 orderbook checkpoints (full snapshots) with user attribution at each price level. Get L4 orderbook checkpoints (full snapshots) with user attribution at each price level. Useful for periodic state verification. Requires Build tier or higher. Data available from March 11, 2026. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orderbook/BTC/l4/history?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid - L2 Full-Depth Order Book (Derived from L4) GET `/v1/hyperliquid/orderbook/:symbol/l2` Copy 3 credit s Get the full-depth L2 orderbook at a specific point in time, derived from L4 data. Get the full-depth L2 orderbook at a specific point in time, derived from L4 data. Returns aggregated price levels (price, total size, order count per level). If no timestamp is provided, returns the current state. Requires Build tier or higher. Data available from April 1, 2026. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `timestamp` query Unix timestamp in ms (omit for current state) `depth` query Number of price levels per side (omit for full depth) Request ``` /v1/hyperliquid/orderbook/BTC/l2?depth=20 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/orderbook/:symbol/l2/history` Copy 10 credit s Get paginated L2 full-depth checkpoints over a time range. Get paginated L2 full-depth checkpoints over a time range. Each checkpoint is a complete orderbook snapshot with all price levels. Requires Build tier or higher. Data available from April 1, 2026. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orderbook/BTC/l2/history?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/orderbook/:symbol/l2/diffs` Copy 5 credit s Get tick-level L2 orderbook deltas showing price-level changes over time. Get tick-level L2 orderbook deltas showing price-level changes over time. Each delta contains price, new size, and side. Requires Pro tier or higher. Data available from April 1, 2026. Parameters `symbol` path required Trading pair (e.g., BTC, ETH) `start` query required Start timestamp in ms `end` query required End timestamp in ms `cursor` query Pagination cursor from previous response `limit` query Max results (default: 100, max: 1000) Request ``` /v1/hyperliquid/orderbook/BTC/l2/diffs?start=1704067200000&end=1704153600000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "BTC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - Pair Metadata (294 pairs: PURR-USDC, HYPE-USDC, HFUN-USDC, ...) GET `/v1/hyperliquid/spot/pairs` Copy 1 credit List all 294 spot pairs with base/quote tokens and dashed symbols. List all 294 spot pairs with base/quote tokens and dashed symbols. No tier restriction. Symbols use the dashed form (e.g., PURR-USDC); the server resolves the wire format (PURR/USDC, @) internally. Request ``` /v1/hyperliquid/spot/pairs ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "base": "PURR", "quote": "USDC", "wire": "PURR/USDC", "pair_index": 107 }, { "symbol": "HYPE-USDC", "base": "HYPE", "quote": "USDC", "wire": "HYPE/USDC", "pair_index": 150 }, { "symbol": "HFUN-USDC", "base": "HFUN", "quote": "USDC", "wire": "HFUN/USDC", "pair_index": 161 } ], "meta": { "request_id": "req_abc123", "count": 3 } } ``` GET `/v1/hyperliquid/spot/pairs/:symbol` Copy 1 credit Get metadata for a single spot pair, including base/quote tokens and the underlying wire-format identifier. Parameters `symbol` path required Spot symbol in dashed form (e.g., PURR-USDC, HYPE-USDC, HFUN-USDC). Raw @ identifiers are not accepted; use the named pair. Request ``` /v1/hyperliquid/spot/pairs/PURR-USDC ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "base": "PURR", "quote": "USDC", "wire": "PURR/USDC", "pair_index": 107 }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/spot/freshness/:symbol` Copy 1 credit Data freshness for a spot pair: latest timestamps and lag for orderbook, trades, L4, and TWAP. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC, HYPE-USDC). Request ``` /v1/hyperliquid/spot/freshness/PURR-USDC ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "exchange": "hyperliquid_spot", "latest_timestamp": "2026-01-01T12:00:00Z", "lag_ms": 1200, "status": "fresh" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` ### Hyperliquid Spot - Order Book (Build+) GET `/v1/hyperliquid/spot/orderbook/:symbol` Copy 1 credit Get current L2 order book for a Hyperliquid Spot pair. Get current L2 order book for a Hyperliquid Spot pair. Build+ tier required. Live-only from 2026-05-05 (Hyperliquid does not publish historical spot orderbook data). Parameters `symbol` path required Spot symbol (e.g., PURR-USDC, HYPE-USDC). `depth` query Price levels per side (max 20). Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC?depth=10 ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50", "spread_bps": "1.19" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/history` Copy 5 credit s Get historical L2 spot orderbook snapshots with cursor pagination. Get historical L2 spot orderbook snapshots with cursor pagination. Available from 2026-05-05. Build+ tier required. Parameters `symbol` path required Spot symbol (e.g., HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `depth` query Price levels per side (max 20). `cursor` query Pagination cursor from previous response. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orderbook/HYPE-USDC/history?start=1746489600000&end=1746576000000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/l4` Copy 10 credit s Full-depth L4 order book reconstruction with user attribution. Full-depth L4 order book reconstruction with user attribution. Pro+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC). `timestamp` query Reconstruct at this Unix ms timestamp; defaults to latest. Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC/l4?timestamp=1746576000000 ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/l4/diffs` Copy 3 credit s L4 order-level changes (place, cancel, modify, fill) with user attribution. L4 order-level changes (place, cancel, modify, fill) with user attribution. Pro+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC/l4/diffs?start=1746489600000&end=1746576000000&limit=500 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/l4/history` Copy 3 credit s L4 checkpoint history. L4 checkpoint history. Build+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC/l4/history?start=1746489600000&end=1746576000000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - Trades (Build+) GET `/v1/hyperliquid/spot/trades/:symbol` Copy 2 credit s Get spot trade history with verbose schema: builder_address, builder_fee, twap_id, fee_token (open-set: USDC, PURR, HYPE, KHYPE, USOL, ...), and real EVM tx_hash (~69% non-zero for spot, vs all-zero for perps). Get spot trade history with verbose schema: builder_address, builder_fee, twap_id, fee_token (open-set: USDC, PURR, HYPE, KHYPE, USOL, ...), and real EVM tx_hash (~69% non-zero for spot, vs all-zero for perps). Backfilled from 2025-03-22; pre-March 2025 spot history is unrecoverable from any free public archive. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC, HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/trades/PURR-USDC?start=1742601600000&end=1742688000000&limit=500 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "side": "B", "price": "42150.50", "size": "0.25", "trade_id": 12345678, "direction": "Open Long" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - Order Lifecycle (Build+) GET `/v1/hyperliquid/spot/orders/:symbol/history` Copy 3 credit s Order lifecycle events (place, cancel, modify, fill) for a spot pair. Order lifecycle events (place, cancel, modify, fill) for a spot pair. Build+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `user` query Filter by user wallet address. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orders/HYPE-USDC/history?start=1746489600000&end=1746576000000&limit=200 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "order_id": "0xabc", "user_address": "0x1234...abcd", "status": "filled", "side": "B", "price": "42150.50", "size": "1.2" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - TWAP (Build+) GET `/v1/hyperliquid/spot/twap/:symbol` Copy 2 credit s TWAP execution events for a spot pair, with parent twap_id, fill schedule, and counter-party attribution. TWAP execution events for a spot pair, with parent twap_id, fill schedule, and counter-party attribution. Build+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/twap/HYPE-USDC?start=1746489600000&end=1746576000000&limit=200 ``` Response ``` { "success": true, "data": [ { "coin": "HYPE/USDC", "symbol": "HYPE-USDC", "twap_id": 7732, "user_address": "0x44ad...8b9c", "side": "A", "slice_price": "24.875", "slice_size": "12.3", "timestamp": "2026-05-05T17:13:25.119Z", "parent_total_size": "120.0", "completed_size": "36.9", "status": "progressing" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/spot/twap/user/:user` Copy 2 credit s TWAP execution events filtered by user wallet across all spot pairs. TWAP execution events filtered by user wallet across all spot pairs. Build+ tier required. Parameters `user` path required User wallet address (0x...). `start` query Start timestamp in ms. `end` query End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/twap/user/0x023a3d058020fb76cca98f01b3c48c8938a22355?limit=100 ``` Response ``` { "success": true, "data": [ { "coin": "HYPE/USDC", "symbol": "HYPE-USDC", "twap_id": 7732, "user_address": "0x44ad...8b9c", "side": "A", "slice_price": "24.875", "slice_size": "12.3", "timestamp": "2026-05-05T17:13:25.119Z", "parent_total_size": "120.0", "completed_size": "36.9", "status": "progressing" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ## Hyperliquid Spot 13 routes under /v1/hyperliquid/spot covering 294 dashed pairs (PURR-USDC, HYPE-USDC, HFUN-USDC, ...): L2/L4 orderbook, trades with builder/twap fields, TWAP by symbol or by user, order lifecycle, pair metadata, and freshness. Spot trades carry fee_token (open-set: USDC, PURR, HYPE, KHYPE, USOL, ...), real EVM tx_hash on roughly 69% of fills, and parent twap_id on TWAP slices. No funding, OI, liquidations, or candles by design (build OHLCV client-side from spot trades). ### Hyperliquid Spot - Pair Metadata (294 pairs: PURR-USDC, HYPE-USDC, HFUN-USDC, ...) GET `/v1/hyperliquid/spot/pairs` Copy 1 credit List all 294 spot pairs with base/quote tokens and dashed symbols. List all 294 spot pairs with base/quote tokens and dashed symbols. No tier restriction. Symbols use the dashed form (e.g., PURR-USDC); the server resolves the wire format (PURR/USDC, @) internally. Request ``` /v1/hyperliquid/spot/pairs ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "base": "PURR", "quote": "USDC", "wire": "PURR/USDC", "pair_index": 107 }, { "symbol": "HYPE-USDC", "base": "HYPE", "quote": "USDC", "wire": "HYPE/USDC", "pair_index": 150 }, { "symbol": "HFUN-USDC", "base": "HFUN", "quote": "USDC", "wire": "HFUN/USDC", "pair_index": 161 } ], "meta": { "request_id": "req_abc123", "count": 3 } } ``` GET `/v1/hyperliquid/spot/pairs/:symbol` Copy 1 credit Get metadata for a single spot pair, including base/quote tokens and the underlying wire-format identifier. Parameters `symbol` path required Spot symbol in dashed form (e.g., PURR-USDC, HYPE-USDC, HFUN-USDC). Raw @ identifiers are not accepted; use the named pair. Request ``` /v1/hyperliquid/spot/pairs/PURR-USDC ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "base": "PURR", "quote": "USDC", "wire": "PURR/USDC", "pair_index": 107 }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/spot/freshness/:symbol` Copy 1 credit Data freshness for a spot pair: latest timestamps and lag for orderbook, trades, L4, and TWAP. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC, HYPE-USDC). Request ``` /v1/hyperliquid/spot/freshness/PURR-USDC ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "exchange": "hyperliquid_spot", "latest_timestamp": "2026-01-01T12:00:00Z", "lag_ms": 1200, "status": "fresh" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` ### Hyperliquid Spot - Order Book (Build+) GET `/v1/hyperliquid/spot/orderbook/:symbol` Copy 1 credit Get current L2 order book for a Hyperliquid Spot pair. Get current L2 order book for a Hyperliquid Spot pair. Build+ tier required. Live-only from 2026-05-05 (Hyperliquid does not publish historical spot orderbook data). Parameters `symbol` path required Spot symbol (e.g., PURR-USDC, HYPE-USDC). `depth` query Price levels per side (max 20). Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC?depth=10 ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50", "spread_bps": "1.19" }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/history` Copy 5 credit s Get historical L2 spot orderbook snapshots with cursor pagination. Get historical L2 spot orderbook snapshots with cursor pagination. Available from 2026-05-05. Build+ tier required. Parameters `symbol` path required Spot symbol (e.g., HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `depth` query Price levels per side (max 20). `cursor` query Pagination cursor from previous response. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orderbook/HYPE-USDC/history?start=1746489600000&end=1746576000000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "bids": [ { "px": "42150.50", "sz": "2.5", "n": 5 } ], "asks": [ { "px": "42151.00", "sz": "1.8", "n": 3 } ], "mid_price": "42150.75", "spread": "0.50" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/l4` Copy 10 credit s Full-depth L4 order book reconstruction with user attribution. Full-depth L4 order book reconstruction with user attribution. Pro+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC). `timestamp` query Reconstruct at this Unix ms timestamp; defaults to latest. Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC/l4?timestamp=1746576000000 ``` Response ``` { "success": true, "data": { "symbol": "PURR-USDC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] }, "meta": { "request_id": "req_abc123", "count": 1 } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/l4/diffs` Copy 3 credit s L4 order-level changes (place, cancel, modify, fill) with user attribution. L4 order-level changes (place, cancel, modify, fill) with user attribution. Pro+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC/l4/diffs?start=1746489600000&end=1746576000000&limit=500 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/spot/orderbook/:symbol/l4/history` Copy 3 credit s L4 checkpoint history. L4 checkpoint history. Build+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orderbook/PURR-USDC/l4/history?start=1746489600000&end=1746576000000&limit=100 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-03-11T12:00:00Z", "bids": [ { "price": "42150.50", "orders": [ { "order_id": "0xabc", "user_address": "0x1234...abcd", "size": "2.5" } ] } ], "asks": [ { "price": "42151.00", "orders": [ { "order_id": "0xdef", "user_address": "0x5678...efgh", "size": "1.8" } ] } ] } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - Trades (Build+) GET `/v1/hyperliquid/spot/trades/:symbol` Copy 2 credit s Get spot trade history with verbose schema: builder_address, builder_fee, twap_id, fee_token (open-set: USDC, PURR, HYPE, KHYPE, USOL, ...), and real EVM tx_hash (~69% non-zero for spot, vs all-zero for perps). Get spot trade history with verbose schema: builder_address, builder_fee, twap_id, fee_token (open-set: USDC, PURR, HYPE, KHYPE, USOL, ...), and real EVM tx_hash (~69% non-zero for spot, vs all-zero for perps). Backfilled from 2025-03-22; pre-March 2025 spot history is unrecoverable from any free public archive. Parameters `symbol` path required Spot symbol (e.g., PURR-USDC, HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/trades/PURR-USDC?start=1742601600000&end=1742688000000&limit=500 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "side": "B", "price": "42150.50", "size": "0.25", "trade_id": 12345678, "direction": "Open Long" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - Order Lifecycle (Build+) GET `/v1/hyperliquid/spot/orders/:symbol/history` Copy 3 credit s Order lifecycle events (place, cancel, modify, fill) for a spot pair. Order lifecycle events (place, cancel, modify, fill) for a spot pair. Build+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `user` query Filter by user wallet address. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/orders/HYPE-USDC/history?start=1746489600000&end=1746576000000&limit=200 ``` Response ``` { "success": true, "data": [ { "symbol": "PURR-USDC", "timestamp": "2026-01-01T12:00:00Z", "order_id": "0xabc", "user_address": "0x1234...abcd", "status": "filled", "side": "B", "price": "42150.50", "size": "1.2" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` ### Hyperliquid Spot - TWAP (Build+) GET `/v1/hyperliquid/spot/twap/:symbol` Copy 2 credit s TWAP execution events for a spot pair, with parent twap_id, fill schedule, and counter-party attribution. TWAP execution events for a spot pair, with parent twap_id, fill schedule, and counter-party attribution. Build+ tier required. Live-only from 2026-05-05. Parameters `symbol` path required Spot symbol (e.g., HYPE-USDC). `start` query required Start timestamp in ms. `end` query required End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/twap/HYPE-USDC?start=1746489600000&end=1746576000000&limit=200 ``` Response ``` { "success": true, "data": [ { "coin": "HYPE/USDC", "symbol": "HYPE-USDC", "twap_id": 7732, "user_address": "0x44ad...8b9c", "side": "A", "slice_price": "24.875", "slice_size": "12.3", "timestamp": "2026-05-05T17:13:25.119Z", "parent_total_size": "120.0", "completed_size": "36.9", "status": "progressing" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ``` GET `/v1/hyperliquid/spot/twap/user/:user` Copy 2 credit s TWAP execution events filtered by user wallet across all spot pairs. TWAP execution events filtered by user wallet across all spot pairs. Build+ tier required. Parameters `user` path required User wallet address (0x...). `start` query Start timestamp in ms. `end` query End timestamp in ms. `cursor` query Pagination cursor. `limit` query Max results (1-1000). Request ``` /v1/hyperliquid/spot/twap/user/0x023a3d058020fb76cca98f01b3c48c8938a22355?limit=100 ``` Response ``` { "success": true, "data": [ { "coin": "HYPE/USDC", "symbol": "HYPE-USDC", "twap_id": 7732, "user_address": "0x44ad...8b9c", "side": "A", "slice_price": "24.875", "slice_size": "12.3", "timestamp": "2026-05-05T17:13:25.119Z", "parent_total_size": "120.0", "completed_size": "36.9", "status": "progressing" } ], "meta": { "request_id": "req_abc123", "count": 1, "next_cursor": "1704067200000_abc123", "has_more": false } } ```