---
title: "Hyperliquid Spot REST API | 0xArchive Docs"
description: "Hyperliquid Spot REST routes under /v1/hyperliquid/spot for 294 dashed pairs: L2/L4 orderbook, trades, TWAP, pair metadata, and freshness."
canonical_url: "https://www.0xarchive.io/docs/rest-api/spot/"
markdown_url: "https://www.0xarchive.io/docs/rest-api/spot.md"
route: "/docs/rest-api/spot"
robots: "index, follow"
generated_from: "prerendered_html"
---

# 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](https://www.0xarchive.io/openapi.json)

## 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/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, @<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/: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 @<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/: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, @<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/: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 @<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/: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
  }
}
```