Hip3OracleDiscoveryBounds Schema

{
  "$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
    }
  }
}