> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Export manifest schemas

> Generated JSON Schema contracts for Data Catalog export selections, manifest payloads, coverage keys, pricing units, and delivery constraints.

JSON Schemas you can validate your own Bulk Exports records against. The export manifest schema describes one market in an order: venue family, market, schema keys, UTC dates, quote, delivery state, and data-rights decision. Each schema key below has its own schema with its label, coverage key, pricing, and rough columns. These schemas are for your records only: a download holds the Parquet files and a `README.md`, and the exact file columns are on [File columns](/schemas/export-files). For a simple record filled from the order page, use the [Order records](/guides/export-historical-data) template.

| Schema key | Label | Coverage key |
| - | - | - |
| `funding` | Funding Rates | `funding` |
| `l2_orderbook` | L2 Order Book | `orderbook` |
| `l3_orderbook` | Individual-Order Book (L3) | `l3_orderbook` |
| `l4_orderbook` | Order-Level Book (L4) | `l4_orderbook` |
| `l4_orders` | Order Events / TP/SL | `l4_orders` |
| `liquidations` | Liquidations | `liquidations` |
| `oi` | Open Interest | `oi` |
| `trades` | Trades | `trades` |

Prices for each schema key are on [Export schemas](/export-schemas#pricing).

## Export manifest JSON Schema

```json theme={"theme":"github-dark"}
{
  "type": "object",
  "required": [
    "venue_family",
    "market",
    "schema_keys",
    "start_date_utc",
    "end_date_utc",
    "coverage_source",
    "estimated_size",
    "credits_or_cost",
    "delivery_status",
    "data_rights_decision"
  ],
  "properties": {
    "venue_family": {
      "type": "string",
      "enum": [
        "Hyperliquid core",
        "Hyperliquid Spot",
        "HIP-3",
        "HIP-4",
        "Lighter",
        "Lighter on Robinhood Chain"
      ]
    },
    "market": {
      "type": "string",
      "description": "Market symbol, pair, builder-prefixed symbol, or outcome identifier."
    },
    "schema_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "l2_orderbook",
          "l3_orderbook",
          "l4_orderbook",
          "l4_orders",
          "trades",
          "funding",
          "oi",
          "liquidations"
        ]
      },
      "minItems": 1
    },
    "start_date_utc": {
      "type": "string",
      "format": "date"
    },
    "end_date_utc": {
      "type": "string",
      "format": "date"
    },
    "coverage_source": {
      "type": "string",
      "description": "Coverage field or selected market row used to approve the range."
    },
    "estimated_size": {
      "type": "string",
      "description": "Estimated file size or GB estimate shown before checkout."
    },
    "credits_or_cost": {
      "type": "string",
      "description": "Quoted credits, dollar cost, or pricing-unit calculation."
    },
    "delivery_status": {
      "type": "string",
      "enum": [
        "estimated",
        "quoted",
        "checkout_opened",
        "paid",
        "processing",
        "delivered",
        "failed",
        "canceled"
      ]
    },
    "data_rights_decision": {
      "type": "string",
      "description": "Whether downstream use materially transforms the source data without exposing or allowing reconstruction of original records, and whether any benchmark, index, financial product, standalone or substitute market-data product, raw redistribution, or white-label or OEM use has written permission."
    }
  },
  "additionalProperties": false
}
```

## Funding Rates

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Funding Rates export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "funding",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Funding Rates"
    },
    "coverage_key": {
      "const": "funding"
    },
    "pricing_unit": {
      "const": "$0.50/GB"
    },
    "minimum": {
      "const": "$2.50 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "funding_rate",
          "premium"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "HIP-3",
          "Lighter",
          "Lighter on Robinhood Chain"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.funding when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "Funding exports are separate from open-interest and candle exports."
      ]
    }
  },
  "additionalProperties": false
}
```

## L2 Order Book

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "L2 Order Book export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "l2_orderbook",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "L2 Order Book"
    },
    "coverage_key": {
      "const": "orderbook"
    },
    "pricing_unit": {
      "const": "$3/GB"
    },
    "minimum": {
      "const": "$5 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "bids",
          "asks",
          "mid_price",
          "spread"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "Hyperliquid Spot",
          "HIP-3",
          "HIP-4",
          "Lighter",
          "Lighter on Robinhood Chain"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.orderbook when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "For settled HIP-4 outcomes, cap the export end date at coverage_to.",
        "Lighter and Lighter on Robinhood Chain deliver the event-resolution change stream with a second file of periodic full-book snapshots (l2_checkpoints) that seeds reconstruction; l2_checkpoints is not selectable on its own."
      ]
    }
  },
  "additionalProperties": false
}
```

## Individual-Order Book (L3)

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Individual-Order Book (L3) export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "l3_orderbook",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Individual-Order Book (L3)"
    },
    "coverage_key": {
      "const": "l3_orderbook"
    },
    "pricing_unit": {
      "const": "$3/GB"
    },
    "minimum": {
      "const": "$5 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "individual_orders",
          "bid_count",
          "ask_count",
          "mid_price",
          "spread"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Lighter"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.l3_orderbook when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "Keep L3 individual-order depth separate from L2 price-level snapshots."
      ]
    }
  },
  "additionalProperties": false
}
```

## Order-Level Book (L4)

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Order-Level Book (L4) export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "l4_orderbook",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Order-Level Book (L4)"
    },
    "coverage_key": {
      "const": "l4_orderbook"
    },
    "pricing_unit": {
      "const": "$4/GB"
    },
    "minimum": {
      "const": "$12.50 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "user_address",
          "side",
          "price",
          "size",
          "change_type",
          "snapshots"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "Hyperliquid Spot",
          "HIP-3",
          "HIP-4"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.l4_orderbook when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "Keep L4 book changes separate from order-event exports."
      ]
    }
  },
  "additionalProperties": false
}
```

## Order Events / TP/SL

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Order Events / TP/SL export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "l4_orders",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Order Events / TP/SL"
    },
    "coverage_key": {
      "const": "l4_orders"
    },
    "pricing_unit": {
      "const": "$4/GB"
    },
    "minimum": {
      "const": "$12.50 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "user_address",
          "order_id",
          "status",
          "side",
          "price",
          "size",
          "order_type"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "Hyperliquid Spot",
          "HIP-3",
          "HIP-4"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.l4_orders when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "Preserve TP/SL and order lifecycle state separately from ordinary trade rows."
      ]
    }
  },
  "additionalProperties": false
}
```

## Liquidations

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Liquidations export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "liquidations",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Liquidations"
    },
    "coverage_key": {
      "const": "liquidations"
    },
    "pricing_unit": {
      "const": "$4/GB"
    },
    "minimum": {
      "const": "$12.50 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "liquidated_user",
          "price",
          "size",
          "side",
          "mark_price",
          "direction"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "HIP-3"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.liquidations when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "Do not request Hyperliquid core liquidations before 2025-03-22 through the export flow."
      ]
    }
  },
  "additionalProperties": false
}
```

## Open Interest

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Open Interest export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "oi",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Open Interest"
    },
    "coverage_key": {
      "const": "oi"
    },
    "pricing_unit": {
      "const": "$0.50/GB"
    },
    "minimum": {
      "const": "$2.50 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "open_interest",
          "mark_price",
          "oracle_price"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "HIP-3",
          "HIP-4",
          "Lighter",
          "Lighter on Robinhood Chain"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.oi when present, otherwise coverage_by_type.open_interest or coverage_from.",
        "Use UTC start and end dates.",
        "HIP-4 price fields are probability-like values, not USD prices."
      ]
    }
  },
  "additionalProperties": false
}
```

## Trades

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Trades export schema selection",
  "type": "object",
  "required": [
    "schema_key",
    "label",
    "coverage_key",
    "pricing_unit",
    "minimum",
    "rough_columns",
    "venue_applicability",
    "date_range_constraints"
  ],
  "properties": {
    "schema_key": {
      "const": "trades",
      "description": "Data Catalog schema key selected for an export."
    },
    "label": {
      "const": "Trades"
    },
    "coverage_key": {
      "const": "trades"
    },
    "pricing_unit": {
      "const": "$4/GB"
    },
    "minimum": {
      "const": "$7.50 minimum"
    },
    "rough_columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "timestamp",
          "symbol",
          "side",
          "price",
          "size",
          "trade_id",
          "user_address",
          "fee",
          "direction"
        ]
      ]
    },
    "venue_applicability": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "enum": [
        [
          "Hyperliquid core",
          "Hyperliquid Spot",
          "HIP-3",
          "HIP-4",
          "Lighter",
          "Lighter on Robinhood Chain"
        ]
      ]
    },
    "date_range_constraints": {
      "type": "string",
      "const": [
        "Use coverage_by_type.trades when present, otherwise coverage_from.",
        "Use UTC start and end dates.",
        "Do not request Hyperliquid core trades, liquidations, or Hyperliquid Spot trades before 2025-03-22 through the export flow.",
        "Lighter on Robinhood Chain trades end at the finalized trade boundary, like Lighter mainnet trades."
      ]
    }
  },
  "additionalProperties": false
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.