Response Schemas - 0xArchive

Generated endpoint pages contain the route-specific schemas. This page covers the shared response model, common market-data payload shapes, and the fields most clients should handle consistently. Use Responses when you need parser behavior, Example Responses when you need payload examples, Examples when you need copyable request code, and Export Schemas when the user is choosing Parquet file datasets.

Schema Source

OpenAPI and the generated endpoint reference are the route-specific contract for REST requests and responses. Generated schema pages are derived from the refreshed local openapi.json so builders can browse component schemas, operation schemas, and route families without treating examples as complete schema coverage. Response examples are teaching artifacts; they are not the schema contract.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "0xArchive response envelope",
  "type": "object",
  "required": ["success"],
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the request succeeded."
    },
    "data": {
      "description": "Route-specific payload documented by the generated operation schema."
    },
    "meta": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer"
        },
        "next_cursor": {
          "type": "string"
        },
        "request_id": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}

Component Schemas

Browse every generated OpenAPI component schema.

Operation Schemas

Open route-level request and response JSON Schema pages.

Hyperliquid Core Schemas

Review generated Hyperliquid core operation contracts.

Hyperliquid Spot Schemas

Review generated Spot operation contracts.

HIP-3 Schemas

Review generated HIP-3 operation contracts.

HIP-4 Schemas

Review generated HIP-4 operation contracts.

Lighter Schemas

Review generated Lighter operation contracts.

Data Quality Schemas

Review generated status, coverage, and quality contracts.

Export Manifest Schemas

Browse generator-backed Data Catalog export manifest schemas.

WebSocket Messages

See the generated bridge to the current WebSocket command inventory.

Envelope

success

boolean

true for successful responses. Error responses use success: false.

data

object | array

Route payload. Historical list routes usually return arrays, while market-state routes often return objects.

meta.count

integer

Number of returned items.

meta.next_cursor

string

Cursor for the next page when a paginated historical route has more results.

meta.request_id

string

Identifier to log for debugging and support.

Schema Families

Family	Schema intent	Example routes
Instruments and pairs	Market discovery and symbol metadata	`/v1/hyperliquid/instruments`, `/v1/hyperliquid/spot/pairs`, `/v1/lighter/instruments`
Order books	Bids, asks, timestamps, spread, depth, and route-specific order-book records	`/orderbook/{symbol}`, L3, L4, and history routes
Trades	Side, price, size, timestamp, and source-specific fields	`/trades/{symbol}` and recent trade routes
Candles	OHLC-style time buckets	`/candles/{symbol}`
Funding and open interest	Timestamped funding, premium, mark/mid context, and OI values	`/funding/{symbol}`, `/openinterest/{symbol}`
Liquidations and orders	Liquidation events, order history, flow, and TPSL records	Liquidation and order routes where available
Spot TWAP	Hyperliquid Spot TWAP records	`/v1/hyperliquid/spot/twap/{symbol}`
Data quality	Coverage, status, incidents, latency, and SLA records	`/v1/data-quality/*`
Wallet auth	SIWE challenge, signup, key, revoke, and subscribe responses	`/v1/auth/web3/challenge`, `/v1/web3/signup`, `/v1/web3/keys`
Export datasets	Parquet schema keys, coverage keys, rough columns, pricing units, and file-delivery metadata	Data Catalog export schemas

Client Schema Packet

Use this packet before generating types, warehouse tables, or agent parser instructions.

Schema decision	Public rule
Route-specific type	Start from the generated endpoint reference in OpenAPI or the route-level pages in Operation Schemas.
Shared envelope	Apply `success`, `data`, `meta.count`, `meta.next_cursor`, and `meta.request_id` handling consistently.
Empty result state	Model `success: true` with an empty array separately from transport failure, auth failure, and missing-route errors.
Venue-specific fields	Keep Spot pairs, HIP-3 prefixes, HIP-4 outcome identifiers, and Lighter symbols distinct.
Decimal values	Treat prices, sizes, rates, spreads, open interest, and probability-like fields as decimal-sensitive.
High-depth books	Keep L2 snapshots, L3 individual orders, L4 book state, and L4 order events as separate schemas.
Export files	Use Export Schemas; do not reuse JSON response schemas as Parquet table contracts without source metadata.

Market Fields

Order books

Order-book payloads include bids, asks, timestamps, mid price, spread, and venue-specific depth fields. L3 and L4 records should be stored separately from ordinary L2 snapshots.

Trades

Trade payloads include side, price, size, timestamp, and route-specific fields such as wallet/account identifiers where the source supports them.

Funding and open interest

Funding and OI payloads include timestamped rate, premium, mark, mid, and open-interest fields depending on venue family.

HIP-4 prices

HIP-4 mark_price and mid_price represent implied probability in [0, 1], not USD.

Data quality records

Coverage, latency, freshness, incident, and SLA payloads are trust signals. A client should compare them to the job tolerance before downstream systems use market data.

Schema Use In Clients

Generated endpoint pages are the source for route-specific schemas. Use this page for shared behavior that should appear in every client: success handling, pagination metadata, request IDs, timestamp parsing, and error propagation. Keep numeric-looking market fields as strings unless the route schema or generated type states otherwise. Prices, sizes, spreads, rates, and open-interest values often need decimal-safe handling. Convert them at the application edge with a decimal library instead of relying on floating-point defaults in strategy, accounting, or model code.

Export Schemas Versus API Schemas

API schemas describe JSON responses from REST and WebSocket surfaces. Export schemas describe file-style Parquet datasets from the Data Catalog. Keep those models separate. An API order-book response, an L2 export, an L3 export, an L4 order-book export, and an order-events export can all represent order-book-adjacent data, but they should not share one warehouse schema without preserving source and schema key. Use Export Schemas for schema keys such as l2_orderbook, l3_orderbook, l4_orderbook, l4_orders, trades, funding, oi, and liquidations.

Venue-Specific Meaning

The same field name can mean different things by venue family. HIP-4 prices are probabilities, not USD prices. Spot symbols are pairs such as HYPE-USDC. HIP-3 symbols can include a builder prefix such as km:US500. Lighter routes live under their own namespace. Preserve the venue family in stored records so downstream joins do not treat unrelated symbols as the same instrument.

Examples And Responses

Examples are teaching artifacts, not the schema source. They should show route family, auth, request IDs, bounded scope, and schema-backed payload shapes, but client code should still parse from the generated schema. Response handling should check HTTP status, success, error.code, pagination metadata, and meta.request_id.

REST API

Open endpoint-specific schemas.

Errors

Handle error responses and request IDs.

Responses

Parse envelopes, pagination, errors, and decimal-sensitive fields.

Example Responses

Review schema-backed JSON examples before writing parsers or tests.

Examples

Copy bounded request, parser, WebSocket, and agent examples.

Export Schemas

Choose Parquet export datasets and preserve schema keys.

Last modified on May 18, 2026

API Playground

Component Schemas

⌘I

Reference start

Generated schemas

Examples and responses

Data and operations

System

Legacy

Hyperliquid - Instruments

Hyperliquid - Order Book

Hyperliquid - Trades

Hyperliquid - Candles

Hyperliquid - Open Interest

Hyperliquid - Funding

Hyperliquid - Liquidations

Hyperliquid - Convenience

Lighter - Instruments

Lighter - Order Book

Lighter - Trades

Lighter - Candles

Lighter - Open Interest

Lighter - Funding

Lighter - Convenience

HIP-3 Builder Perps - Instruments

HIP-3 Builder Perps - Order Book

HIP-3 Builder Perps - Trades

HIP-3 Builder Perps - Candles

HIP-3 Builder Perps - Open Interest

HIP-3 Builder Perps - Funding

HIP-3 Builder Perps - Liquidations

HIP-3 Builder Perps - Convenience

Data Quality

Web3 Authentication

Hyperliquid - Orders

Hyperliquid - L4 Order Book

HIP-3 Builder Perps - Orders

HIP-3 Builder Perps - L4 Order Book

HIP-4 Outcomes - Outcomes

HIP-4 Outcomes - Instruments

HIP-4 Outcomes - Order Book

HIP-4 Outcomes - Trades

HIP-4 Outcomes - Open Interest

HIP-4 Outcomes - Convenience

HIP-4 Outcomes - Orders

Lighter - L3 Order Book

Hyperliquid Spot

Hyperliquid Spot - Candles

HIP-4 Outcomes - Candles

Documentation Index

​Schema Source

Component Schemas

Operation Schemas

Hyperliquid Core Schemas

Hyperliquid Spot Schemas

HIP-3 Schemas

HIP-4 Schemas

Lighter Schemas

Data Quality Schemas

Export Manifest Schemas

WebSocket Messages

​Envelope

​Schema Families

​Client Schema Packet

​Market Fields

​Schema Use In Clients

​Export Schemas Versus API Schemas

​Venue-Specific Meaning

​Examples And Responses

REST API

Errors

Responses

Example Responses

Examples

Export Schemas

Schema Source

Envelope

Schema Families

Client Schema Packet

Market Fields

Schema Use In Clients

Export Schemas Versus API Schemas

Venue-Specific Meaning

Examples And Responses