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

# Hip3OracleDiscoveryBounds Schema

> Instantaneous HIP-3 discovery bounds derived from the current reference price and max leverage. Includes schemas, examples, and implementation notes.

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

Instantaneous HIP-3 discovery bounds derived from the current reference price and max leverage.

## Required Fields

| Field | Type | Description |
| - | - | - |
| `block_number` | integer:int64 | Source block number. |
| `bound_fraction` | number | Fraction applied on each side of reference\_price. |
| `lower_bound` | number | Instantaneous lower discovery bound. |
| `max_leverage` | integer | Market max leverage used for the bound fraction. |
| `reference_price` | number | External price when available, otherwise mark price. |
| `reference_source` | string | Price source used for the bounds. |
| `symbol` | string | HIP-3 symbol. |
| `timestamp` | integer:int64 | Source timestamp in Unix milliseconds. |
| `upper_bound` | number | Instantaneous upper discovery bound. |

## JSON Schema

```json theme={"theme":"github-dark"}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Hip3OracleDiscoveryBounds",
  "description": "Instantaneous HIP-3 discovery bounds derived from the current reference price and max leverage.",
  "type": "object",
  "required": [
    "block_number",
    "bound_fraction",
    "lower_bound",
    "max_leverage",
    "reference_price",
    "reference_source",
    "symbol",
    "timestamp",
    "upper_bound"
  ],
  "properties": {
    "block_number": {
      "description": "Source block number.",
      "type": "integer",
      "format": "int64",
      "example": 1038634032
    },
    "bound_fraction": {
      "description": "Fraction applied on each side of reference_price.",
      "type": "number",
      "example": 0.05
    },
    "lower_bound": {
      "description": "Instantaneous lower discovery bound.",
      "type": "number",
      "example": 714.628
    },
    "max_leverage": {
      "description": "Market max leverage used for the bound fraction.",
      "type": "integer",
      "example": 20
    },
    "reference_price": {
      "description": "External price when available, otherwise mark price.",
      "type": "number",
      "example": 752.24
    },
    "reference_source": {
      "description": "Price source used for the bounds.",
      "type": "string",
      "enum": [
        "external",
        "mark"
      ],
      "example": "external"
    },
    "symbol": {
      "description": "HIP-3 symbol.",
      "type": "string",
      "example": "km:US500"
    },
    "timestamp": {
      "description": "Source timestamp in Unix milliseconds.",
      "type": "integer",
      "format": "int64",
      "example": 1781678086894
    },
    "upper_bound": {
      "description": "Instantaneous upper discovery bound.",
      "type": "number",
      "example": 789.852
    }
  }
}
```

## Components using this schema

* [ApiResponseHip3OracleDiscoveryBounds](/schemas/components/api-response-hip3-oracle-discovery-bounds)

## 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/oracle/discovery-bounds/{symbol}`](/schemas/operations/get-hip3-oracle-discovery-bounds)


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