---
title: "Official OI history for a whole dex"
method: GET
path: "/api/public/v1/live/official-oi"
tags: ["Live Markets"]
---

# Official OI history for a whole dex

`GET /api/public/v1/live/official-oi`

Per-coin open-interest history for EVERY coin on the requested dex in one response, from Hyperliquid's official market snapshots (open interest, mark price, and rolling 24h notional volume per snapshot). The batch replaces N calls to /live/official-oi/{coin} with one window scan; the per-coin route remains for single-market callers. Hours is clamped to the 90-day product ceiling (1..2160). Coins are grouped in symbol order with each history ascending by time; a coin with no snapshots in the window is simply absent.

## Query parameters

- `dex` string — Dex to list (hl for native, or a builder-dex prefix like xyz, km, cash)
- `hours` integer — Look-back window in hours (clamped to 1..2160)

## Response `200`

OK

- OfficialOIBatchBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `coins` OfficialOICoinSeries[], nullable, required
    - `coin` string, required
    - `history` OfficialOIEntry[], nullable, required
      - `coin` string, required
      - `dayNtlVlm` number, double, required
      - `dex` string, required
      - `markPx` number, double, required
      - `openInterest` number, double, required
      - `timestamp` integer, required
  - `dex` string, required
  - `hours` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) · [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coinversa/coinversa-api/revisions/77c03c427063/schema)