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

# MaBreadthReading Schema

> One moving-average breadth reading: the last reading of a bucket. Includes route metadata, schemas, examples, and implementation notes.

Source OpenAPI: 0xArchive API 1.13.0; 242 paths; 243 component schemas.

One moving-average breadth reading: the last reading of a bucket.

## Required Fields

| Field | Type | Description |
| - | - | - |
| `calculated_at` | string:date-time | The reading's instant: the bucket's end, or for the bucket still forming the newest settled minute, about 4 minutes before now. |
| `calculated_at_ms` | integer:int64 | `calculated_at` as Unix milliseconds. |
| `counts` | object | The counts a moving-average breadth reading is made from. |
| `coverage_ratio` | number:double | eligible / candidates, to 4 decimals. |
| `distance` | object | Quartiles of price / average - 1 over the eligible perps, to 6 decimals, linear interpolation. |
| `is_final` | boolean | Every candle the reading uses is final. |
| `method` | string | Version of the method: `ma-breadth/1`. |
| `n` | integer | The moving average's length in days. |
| `timestamp` | string:date-time | Bucket open time, RFC 3339 UTC. |
| `timestamp_ms` | integer:int64 | `timestamp` as Unix milliseconds. |
| `value_pct` | number:double | 100 \* above / eligible, to 4 decimals. |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "MaBreadthReading",
  "description": "One moving-average breadth reading: the last reading of a bucket.",
  "type": "object",
  "required": [
    "calculated_at",
    "calculated_at_ms",
    "counts",
    "coverage_ratio",
    "distance",
    "is_final",
    "method",
    "n",
    "timestamp",
    "timestamp_ms",
    "value_pct"
  ],
  "properties": {
    "calculated_at": {
      "description": "The reading's instant: the bucket's end, or for the bucket still forming the newest settled minute, about 4 minutes before now.",
      "type": "string",
      "format": "date-time",
      "example": "2026-10-21T00:00:00.000Z"
    },
    "calculated_at_ms": {
      "description": "`calculated_at` as Unix milliseconds.",
      "type": "integer",
      "format": "int64",
      "example": 1792540800000
    },
    "counts": {
      "description": "The counts a moving-average breadth reading is made from. `above + at + below = eligible`; `eligible + excluded_stale_price + excluded_short_history = candidates`.",
      "type": "object",
      "required": [
        "above",
        "at",
        "below",
        "candidates",
        "eligible",
        "excluded_short_history",
        "excluded_stale_price"
      ],
      "properties": {
        "above": {
          "description": "Eligible perps whose price is above their n-day moving average.",
          "type": "integer",
          "example": 61
        },
        "at": {
          "description": "Eligible perps whose price equals their n-day moving average.",
          "type": "integer",
          "example": 0
        },
        "below": {
          "description": "Eligible perps whose price is below their n-day moving average.",
          "type": "integer",
          "example": 116
        },
        "candidates": {
          "description": "Every perp the venue has listed, from its first one-minute candle on, delisted perps included.",
          "type": "integer",
          "example": 221
        },
        "eligible": {
          "description": "Candidates with a recent price and n days of history: the denominator of `value_pct`.",
          "type": "integer",
          "example": 177
        },
        "excluded_short_history": {
          "description": "Candidates younger than n UTC days before the reading's day.",
          "type": "integer",
          "example": 1
        },
        "excluded_stale_price": {
          "description": "Candidates with no one-minute close in the 24 hours before the reading. A delisted perp is counted here from 24 hours after its last trade.",
          "type": "integer",
          "example": 43
        }
      }
    },
    "coverage_ratio": {
      "description": "eligible / candidates, to 4 decimals. It depends on n and falls as perps delist: it is not a data-quality measure and is not comparable with breadth above session VWAP.",
      "type": "number",
      "format": "double",
      "minimum": 0,
      "maximum": 1,
      "example": 0.8009
    },
    "distance": {
      "description": "Quartiles of price / average - 1 over the eligible perps, to 6 decimals, linear interpolation. Each is null when nothing is eligible, never 0.",
      "type": "object",
      "required": [
        "median",
        "p25",
        "p75"
      ],
      "properties": {
        "median": {
          "type": "number",
          "format": "double",
          "nullable": true,
          "example": -0.027606
        },
        "p25": {
          "type": "number",
          "format": "double",
          "nullable": true,
          "example": -0.09803
        },
        "p75": {
          "type": "number",
          "format": "double",
          "nullable": true,
          "example": 0.036555
        }
      }
    },
    "is_final": {
      "description": "Every candle the reading uses is final. A final reading changes only if the candles it uses are rebuilt.",
      "type": "boolean",
      "example": true
    },
    "method": {
      "description": "Version of the method: `ma-breadth/1`.",
      "type": "string",
      "example": "ma-breadth/1"
    },
    "n": {
      "description": "The moving average's length in days.",
      "type": "integer",
      "enum": [
        5,
        20,
        50,
        200
      ],
      "example": 50
    },
    "timestamp": {
      "description": "Bucket open time, RFC 3339 UTC.",
      "type": "string",
      "format": "date-time",
      "example": "2026-10-20T00:00:00.000Z"
    },
    "timestamp_ms": {
      "description": "`timestamp` as Unix milliseconds.",
      "type": "integer",
      "format": "int64",
      "example": 1792454400000
    },
    "value_pct": {
      "description": "100 * above / eligible, to 4 decimals. Null when nothing is eligible, never 0.",
      "type": "number",
      "format": "double",
      "nullable": true,
      "example": 34.4633
    }
  }
}
```

## Referenced components

* [MaBreadthCounts](https://docs.0xarchive.io/schemas/components/ma-breadth-counts.md)
* [MaBreadthDistance](https://docs.0xarchive.io/schemas/components/ma-breadth-distance.md)

## Components using this schema

* [ApiResponseMaBreadthReading](https://docs.0xarchive.io/schemas/components/api-response-ma-breadth-reading.md)
* [ApiResponseMaBreadthReadingArray](https://docs.0xarchive.io/schemas/components/api-response-ma-breadth-reading-array.md)

## 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/breadth/above-ma`](https://docs.0xarchive.io/schemas/operations/get-breadth-above-ma)
* [`GET /v1/hyperliquid/breadth/above-ma/current`](https://docs.0xarchive.io/schemas/operations/get-breadth-above-ma-current)
* [`GET /v1/hyperliquid/hip3/breadth/above-ma`](https://docs.0xarchive.io/schemas/operations/get-hip3-breadth-above-ma)
* [`GET /v1/hyperliquid/hip3/breadth/above-ma/current`](https://docs.0xarchive.io/schemas/operations/get-hip3-breadth-above-ma-current)


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