> ## 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.6.1; 147 paths; 128 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
    }
  }
}
```

## Referenced By

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