Skip to main content
Source OpenAPI: 0xArchive API 1.14.0; 242 paths; 243 component schemas. Get historical trades (fills) for a coin within a time range. Includes full execution details like fees, PnL, and position direction. Data available from April 2023. History before 2025-03-22 comes from a capped per-user API backfill and is incomplete, especially for maker-side and high-volume activity. Pagination: Use the cursor parameter with the value from the previous response’s next_cursor for efficient pagination.

Route Metadata

Human endpoint reference

Open GET /v1/hyperliquid/trades/{symbol} for authentication, parameters, responses, and examples.

Implementation context

Request Parameters

Path Parameters

Query Parameters

Header Parameters

Response Contracts

Status 200

List of trades with cursor for next page

application/json

Status 400

Invalid request: a parameter, symbol, interval, cursor or time range failed validation. See error_code.

application/json

OpenAPI example: current_main
OpenAPI example: invalid_parameter
OpenAPI example: invalid_symbol
OpenAPI example: invalid_time_range
OpenAPI example: legacy_invalid_query_params

Status 401

Authentication required: the API key is missing or invalid.

application/json

OpenAPI example

Status 403

The request is outside the plan’s history window or per-request span, or the key is not allowed to make it.

application/json

OpenAPI example: historical_depth_exceeded
OpenAPI example: historical_range_exceeded

Status 429

Rate limit, concurrency limit or monthly credits exceeded. See error_code.

application/json

OpenAPI example: insufficient_credits
OpenAPI example: rate_limited

Status default

Any other error. The body is an ErrorResponse; branch on error_code. A 503 (upstream_unavailable) carries Retry-After.

application/json

OpenAPI example: internal_error
OpenAPI example: upstream_unavailable
Last modified on November 17, 2026