Hyperliquid Spot REST API

Hyperliquid Spot REST routes under /v1/hyperliquid/spot for orderbook (L2 + L4), trades, TWAP, pair metadata, and freshness across 294 spot pairs. 12 documented routes. Symbols use the dashed form (PURR-USDC, HYPE-USDC, HFUN-USDC); the server resolves the wire format (PURR/USDC, @<index>) internally.

Routes
12 documented routes
Namespace
/v1/hyperliquid/spot
Pairs
294 (PURR-USDC, HYPE-USDC, HFUN-USDC, ...)
Fills
Backfilled to 2025-03-22
Orderbook
Live-only from 2026-05-05
Not in scope
No funding, OI, liquidations, or candles
OpenAPI Spec

Hyperliquid

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

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
  }
}