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

# TriggerLevelsHistoryItem Schema

> One historical trigger-levels snapshot (15-minute cadence). Includes route metadata, schemas, examples, and implementation notes.

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

One historical trigger-levels snapshot (15-minute cadence). levels is omitted when summary=true.

## Required Fields

| Field | Type | Description |
| - | - | - |
| `mid_price` | number | Defined by the generated JSON Schema block. |
| `snapshot_ts` | string | Defined by the generated JSON Schema block. |
| `total_ask_size` | number | Defined by the generated JSON Schema block. |
| `total_bid_size` | number | Defined by the generated JSON Schema block. |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "TriggerLevelsHistoryItem",
  "description": "One historical trigger-levels snapshot (15-minute cadence). levels is omitted when summary=true.",
  "type": "object",
  "required": [
    "mid_price",
    "snapshot_ts",
    "total_ask_size",
    "total_bid_size"
  ],
  "properties": {
    "levels": {
      "type": "array",
      "items": {
        "description": "Aggregated currently open trigger orders at one rounded price bucket.",
        "type": "object",
        "required": [
          "ask_count",
          "ask_size",
          "bid_count",
          "bid_size",
          "price_bucket"
        ],
        "properties": {
          "ask_count": {
            "description": "Number of ask-side trigger orders in the bucket.",
            "type": "integer",
            "format": "int64",
            "example": 9
          },
          "ask_size": {
            "description": "Ask-side trigger size in the bucket.",
            "type": "number",
            "example": 18.75
          },
          "bid_count": {
            "description": "Number of bid-side trigger orders in the bucket.",
            "type": "integer",
            "format": "int64",
            "example": 12
          },
          "bid_size": {
            "description": "Bid-side trigger size in the bucket.",
            "type": "number",
            "example": 31.25
          },
          "price_bucket": {
            "description": "Rounded trigger price bucket.",
            "type": "number",
            "example": 64200
          }
        }
      }
    },
    "mid_price": {
      "type": "number"
    },
    "snapshot_ts": {
      "type": "string"
    },
    "total_ask_size": {
      "type": "number"
    },
    "total_bid_size": {
      "type": "number"
    }
  }
}
```

## Referenced components

* [TriggerLevel](/schemas/components/trigger-level)

## Components using this schema

* [ApiResponseTriggerLevelsHistory](/schemas/components/api-response-trigger-levels-history)

## 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/orders/{symbol}/trigger-levels/history`](/schemas/operations/get-hip3-trigger-levels-history)
* [`GET /v1/hyperliquid/orders/{symbol}/trigger-levels/history`](/schemas/operations/get-hyperliquid-trigger-levels-history)


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