Legacy

Get trades with cursor pagination (Deprecated)

Deprecated: use /v1/hyperliquid/trades/{symbol}, which serves the same Hyperliquid data. Responses carry Deprecation: true and Link: </v1/hyperliquid/>; rel="successor-version". No removal date is set.

Get historical trades using cursor-based pagination. This is the same as /v1/trades/{symbol} with cursor pagination (which is now the default). This endpoint is maintained for backwards compatibility and explicit cursor-only usage.

get/v1/trades/{symbol}/cursor

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/trades/{symbol}/cursor
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required
Example:BTC

Trading pair symbol (e.g., BTC, ETH, SOL)

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start timestamp. Defaults to 24h ago. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

End timestamp. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

side'buy' | 'sell'

Keep one side of the tape: buy or sell (case-insensitive). Omit it for both. The filter runs before paging, so a full page still holds limit matching trades and the cursor pages the filtered tape. Any other value answers 400 invalid_parameter with param and valid_values.

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page. The cursor is an opaque string that should be passed as-is.

limitinteger

Maximum number of results (default: 100, max: 1000)

Response

List of trades with cursor for next page

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "coin": "BTC",
      "side": "B",
      "price": "42150.50",
      "size": "0.5",
      "timestamp": "2025-01-21T10:30:45.123Z"
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.