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

Hyperliquid

Core perp routes for market state, history, order flow, liquidations, and monitoring.

Hyperliquid - Order Book

GET/v1/hyperliquid/orderbook/:symbol1 credit

Get current order book or snapshot at specific timestamp

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
timestampqueryUnix timestamp in ms for historical snapshot
depthqueryNumber 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/history5 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax results (default: 100, max: 1000)
depthqueryNumber 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/:symbol2 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (next_cursor)
limitqueryMax 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/instruments1 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/:symbol1 credit

Get a single Hyperliquid instrument by symbol, including the latest venue metadata and trading state.

Parameters

symbolpathrequiredTrading 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/:symbol2 credits

Get historical open interest data with market context.

Get historical open interest data with market context. Data available from May 2023.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (next_cursor)
limitqueryMax results (default: 100, max: 1000)
intervalqueryAggregation 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/current1 credit

Get current open interest for a symbol

Parameters

symbolpathrequiredTrading 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/:symbol2 credits

Get historical funding rates.

Get historical funding rates. Data available from May 2023.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (next_cursor)
limitqueryMax results (default: 100, max: 1000)
intervalqueryAggregation 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/current1 credit

Get current funding rate for a symbol

Parameters

symbolpathrequiredTrading 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/:symbol3 credits

Get liquidation events for a symbol.

Get liquidation events for a symbol. Data available from December 2025+.

Parameters

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryCursor from previous response (format: timestamp_tradeId)
limitqueryMax 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/:user3 credits

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

userpathrequiredUser wallet address (e.g., 0x...)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
symbolqueryOptional symbol filter (e.g., BTC)
cursorqueryCursor from previous response
limitqueryMax 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/volume3 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryStart timestamp (Unix ms or ISO 8601). Defaults to 24h ago.
endqueryEnd timestamp (Unix ms or ISO 8601). Defaults to now.
intervalqueryAggregation interval: 5m, 15m, 30m, 1h (default), 4h, 1d
limitqueryMax results (default: 100, max: 1000)
cursorqueryPagination 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/:symbol1 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

symbolpathrequiredTrading 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/:symbol2 credits

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

symbolpathrequiredTrading 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/:symbol2 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryStart timestamp (Unix ms or ISO 8601). Defaults to 24h ago.
endqueryEnd timestamp (Unix ms or ISO 8601). Defaults to now.
intervalqueryAggregation interval: 5m, 15m, 30m, 1h, 4h, 1d. When omitted, returns raw data.
limitqueryMax results (default: 100, max: 1000)
cursorqueryPagination 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/:symbol3 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
intervalqueryCandle interval: 1m, 5m, 15m, 30m, 1h (default), 4h, 1d, 1w
cursorqueryPagination cursor from previous response
limitqueryMax 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/history5 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
userqueryFilter by user wallet address (e.g., 0x...)
statusqueryFilter by order status (e.g., open, filled, cancelled)
order_typequeryFilter by order type (e.g., limit, market)
cursorqueryPagination cursor from previous response
limitqueryMax 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/flow5 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
intervalqueryAggregation interval (e.g., 1m, 5m, 15m, 1h)
limitqueryMax 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/tpsl5 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
userqueryFilter by user wallet address (e.g., 0x...)
triggeredqueryFilter by triggered status (true/false)
cursorqueryPagination cursor from previous response
limitqueryMax 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/l410 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
timestampqueryrequiredUnix timestamp in ms for reconstruction point
depthqueryNumber 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/diffs5 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax 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/history10 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax 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/l23 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
timestampqueryUnix timestamp in ms (omit for current state)
depthqueryNumber 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/history10 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax 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/diffs5 credits

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

symbolpathrequiredTrading pair (e.g., BTC, ETH)
startqueryrequiredStart timestamp in ms
endqueryrequiredEnd timestamp in ms
cursorqueryPagination cursor from previous response
limitqueryMax 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/pairs1 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, @<index>) 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/:symbol1 credit

Get metadata for a single spot pair, including base/quote tokens and the underlying wire-format identifier.

Parameters

symbolpathrequiredSpot symbol in dashed form (e.g., PURR-USDC, HYPE-USDC, HFUN-USDC). Raw @<index> 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/:symbol1 credit

Data freshness for a spot pair: latest timestamps and lag for orderbook, trades, L4, and TWAP.

Parameters

symbolpathrequiredSpot 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/:symbol1 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

symbolpathrequiredSpot symbol (e.g., PURR-USDC, HYPE-USDC).
depthqueryPrice 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/history5 credits

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

symbolpathrequiredSpot symbol (e.g., HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
depthqueryPrice levels per side (max 20).
cursorqueryPagination cursor from previous response.
limitqueryMax 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/l410 credits

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

symbolpathrequiredSpot symbol (e.g., PURR-USDC).
timestampqueryReconstruct 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/diffs3 credits

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

symbolpathrequiredSpot symbol (e.g., PURR-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/history3 credits

L4 checkpoint history.

L4 checkpoint history. Build+ tier required. Live-only from 2026-05-05.

Parameters

symbolpathrequiredSpot symbol (e.g., PURR-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/:symbol2 credits

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

symbolpathrequiredSpot symbol (e.g., PURR-USDC, HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/history3 credits

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

symbolpathrequiredSpot symbol (e.g., HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
userqueryFilter by user wallet address.
cursorqueryPagination cursor.
limitqueryMax 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/:symbol2 credits

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

symbolpathrequiredSpot symbol (e.g., HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/:user2 credits

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

userpathrequiredUser wallet address (0x...).
startqueryStart timestamp in ms.
endqueryEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/pairs1 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, @<index>) 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/:symbol1 credit

Get metadata for a single spot pair, including base/quote tokens and the underlying wire-format identifier.

Parameters

symbolpathrequiredSpot symbol in dashed form (e.g., PURR-USDC, HYPE-USDC, HFUN-USDC). Raw @<index> 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/:symbol1 credit

Data freshness for a spot pair: latest timestamps and lag for orderbook, trades, L4, and TWAP.

Parameters

symbolpathrequiredSpot 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/:symbol1 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

symbolpathrequiredSpot symbol (e.g., PURR-USDC, HYPE-USDC).
depthqueryPrice 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/history5 credits

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

symbolpathrequiredSpot symbol (e.g., HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
depthqueryPrice levels per side (max 20).
cursorqueryPagination cursor from previous response.
limitqueryMax 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/l410 credits

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

symbolpathrequiredSpot symbol (e.g., PURR-USDC).
timestampqueryReconstruct 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/diffs3 credits

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

symbolpathrequiredSpot symbol (e.g., PURR-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/history3 credits

L4 checkpoint history.

L4 checkpoint history. Build+ tier required. Live-only from 2026-05-05.

Parameters

symbolpathrequiredSpot symbol (e.g., PURR-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/:symbol2 credits

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

symbolpathrequiredSpot symbol (e.g., PURR-USDC, HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/history3 credits

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

symbolpathrequiredSpot symbol (e.g., HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
userqueryFilter by user wallet address.
cursorqueryPagination cursor.
limitqueryMax 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/:symbol2 credits

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

symbolpathrequiredSpot symbol (e.g., HYPE-USDC).
startqueryrequiredStart timestamp in ms.
endqueryrequiredEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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/:user2 credits

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

userpathrequiredUser wallet address (0x...).
startqueryStart timestamp in ms.
endqueryEnd timestamp in ms.
cursorqueryPagination cursor.
limitqueryMax 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
  }
}