> ## 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.

# L2OrderBookDiff Schema

> Full-depth L2 aggregate diff event derived from L4 deltas. Includes parameters, response shapes, examples, and implementation notes from the 0xArchive contract.

Source OpenAPI: 0xArchive API 1.8.0; 227 paths; 217 component schemas.

Full-depth L2 aggregate diff event derived from L4 deltas

## Required Fields

| Field | Type | Description |
| - | - | - |
| `block_number` | integer:int64 | Hyperliquid block number for the diff event |
| `count` | integer | Number of orders at the price level after the diff |
| `price` | number | Price level changed by this diff |
| `side` | string | Book side: B for bid, A for ask |
| `size` | number | Aggregate size at the price level after the diff |
| `timestamp` | string:date-time | Diff timestamp (UTC) |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "L2OrderBookDiff",
  "description": "Full-depth L2 aggregate diff event derived from L4 deltas",
  "type": "object",
  "required": [
    "block_number",
    "count",
    "price",
    "side",
    "size",
    "timestamp"
  ],
  "properties": {
    "block_number": {
      "description": "Hyperliquid block number for the diff event",
      "type": "integer",
      "format": "int64",
      "example": 1023882395
    },
    "count": {
      "description": "Number of orders at the price level after the diff",
      "type": "integer",
      "example": 3
    },
    "price": {
      "description": "Price level changed by this diff",
      "type": "number",
      "example": 61088
    },
    "side": {
      "description": "Book side: B for bid, A for ask",
      "type": "string",
      "enum": [
        "B",
        "A"
      ],
      "example": "B"
    },
    "size": {
      "description": "Aggregate size at the price level after the diff",
      "type": "number",
      "example": 0.40603
    },
    "timestamp": {
      "description": "Diff timestamp (UTC)",
      "type": "string",
      "format": "date-time",
      "example": "2026-06-05T13:53:33.971Z"
    }
  }
}
```

## Components using this schema

* [ApiResponseL2OrderBookDiffArray](/schemas/components/api-response-l2-order-book-diff-array)

## Referenced By

Use this shared schema with the generated component index and route-specific endpoint pages during implementation.

## Operations using this component transitively

* [`GET /v1/hyperliquid/hip3/orderbook/{symbol}/l2/diffs`](/schemas/operations/get-hip3-full-depth-l2-diffs)
* [`GET /v1/hyperliquid/orderbook/{symbol}/l2/diffs`](/schemas/operations/get-hyperliquid-full-depth-l2-diffs)


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