Skip to main content
Source OpenAPI: 0xArchive API 1.14.0; 242 paths; 243 component schemas. Get the latest order book snapshot for a coin, or at a specific timestamp. Returns L2 depth with price, size, and order count at each level. Tick-level resolution. The book’s timestamp is the time of its last recorded change at or before the requested instant, or of the checkpoint when nothing changed after it (for the latest book, the newest of these), not the instant requested.

Route Metadata

Human endpoint reference

Open GET /v1/lighter/orderbook/{symbol} for authentication, parameters, responses, and examples.

Request Parameters

Path Parameters

Query Parameters

Header Parameters

Response Contracts

Status 200

Order book snapshot

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 404

Not found. not_found: the resource id is unknown. unsupported_for_venue: the venue does not offer this datatype (available_on names where it is served). route_not_found: no route matches the path.

application/json

OpenAPI example: current_main
OpenAPI example: not_found
OpenAPI example: route_not_found
OpenAPI example: unsupported_for_venue

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