Hip3Instrument Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Hip3Instrument",
  "description": "HIP-3 Builder Perps instrument with latest market data. Derived from live open interest data.",
  "type": "object",
  "required": [
    "coin",
    "namespace",
    "symbol",
    "ticker"
  ],
  "properties": {
    "coin": {
      "description": "Full coin name (e.g., km:US500, xyz:XYZ100) (deprecated, use symbol instead)",
      "type": "string",
      "deprecated": true,
      "example": "km:US500"
    },
    "latest_timestamp": {
      "description": "Timestamp of latest data point",
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "example": "2026-02-18T12:00:00.000Z"
    },
    "mark_price": {
      "description": "Latest mark price",
      "type": "number",
      "nullable": true,
      "example": 5432.1
    },
    "mid_price": {
      "description": "Latest mid price",
      "type": "number",
      "nullable": true,
      "example": 5432.05
    },
    "namespace": {
      "description": "Builder namespace (e.g., km, xyz)",
      "type": "string",
      "example": "km"
    },
    "open_interest": {
      "description": "Latest open interest",
      "type": "number",
      "nullable": true,
      "example": 1234567.89
    },
    "symbol": {
      "description": "Trading pair symbol",
      "type": "string",
      "example": "km:US500"
    },
    "ticker": {
      "description": "Ticker within the namespace (e.g., US500, XYZ100)",
      "type": "string",
      "example": "US500"
    }
  }
}