> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Open Interest API

> The whole derivatives market's open interest hour by hour over 30 days: by venue, by asset class (crypto and five RWA classes), by asset, and BTC's price beside it.

Open interest across every perpetual and dated futures venue Sharpe reads, hour by hour over the last 30 days: each venue's crypto and RWA open interest, each asset class's total, the largest assets of each class with their split by venue, and every asset holding \$100,000 or more now. The [Open Interest page](https://www.sharpe.ai/open-interest) charts the same board.

***

## Open interest across the market

`GET /v1/open-interest`

Open interest is counted one side, in US dollars at each hour's close (each contract's last reading at or before the hour's end), summed over every contract. An asset is the instrument master's asset, so every spelling of one coin (`1000PEPE`, `kPEPE`, `PEPE`) is one asset, and two assets that share a ticker stay two. Its class comes from the master: equities, commodities, ETFs, pre-IPO, indices and FX are RWA; everything else is crypto. tradeXYZ, Hyperliquid's HIP-3 xyz dex, is counted as Hyperliquid.

MEXC and BingX are left out of every total, as on every Sharpe board. So is any venue with no reading at the board's last hour: since 10 November 2026 Deribit publishes open interest 8 hours late, and counting it would make every total fall at the end of the window. `left_out` names each venue and why. The board is rebuilt every hour at :58 UTC, after the hour that just closed has reached Sharpe's history store, so its last hour is one or two hours before the current one. The MCP tool is `get_open_interest_market`.

### Query parameters

**days** `integer`

Days of hourly series, ending at the last whole hour: `1` to `30`. Defaults to `30`.

### Response fields

**hours** `string[]`

Each hour's start (UTC, ISO 8601), oldest first. Every series below has one value per hour; `null` means nothing was read that hour, never 0.

**left\_out** `array`

Venues in no series or total: `exchange`, `newest_hour` (the newest hour it has a reading for, `null` for a venue kept out of totals everywhere) and `reason`.

**venues** `array`

Every venue with a reading in the window, the largest at the last hour first: `exchange`, then hourly `crypto` and `rwa` open interest and `ex_majors` (crypto less BTC and ETH). A venue that read in an hour but lists no contract of a class holds 0 of it; a venue that did not read is `null`.

**classes** `array`

Crypto and each RWA class: `asset_class` (`crypto`, `equity`, `commodity`, `etf`, `preipo`, `index`, `fx`), `label`, its hourly total and `venues_now` (each venue's open interest in the class at the last hour, largest first).

**assets** `array`

Each class's largest assets at the last hour (20 crypto, 15 equities, 8 commodities, 5 each of ETFs, pre-IPO and indices, 3 FX), largest first: `asset_id` (the master's id), `symbol`, `asset_class`, `logo_url`, the hourly total and `venues_now`.

**directory** `array`

Every asset holding \$100,000 or more at the last hour, largest first: `asset_id`, `symbol`, `asset_class`, `logo_url` and `oi`.

**btc\_price** `(number | null)[]`

BTC's hourly close on Binance's BTCUSDT perpetual, aligned to `hours`.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/open-interest \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d days=7
```

```ts TypeScript theme={null}
const res = await fetch('https://www.sharpe.ai/api/v1/open-interest?days=7', {
  headers: {
    Authorization: 'Bearer sk_live_your_key_here',
  },
})
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/open-interest",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
    params={"days": 7},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "data": {
    "hours": ["2026-11-12T05:00:00.000Z", "…", "2026-11-19T05:00:00.000Z"],
    "left_out": [
      { "exchange": "MEXC", "newest_hour": null, "reason": "holdVol moves 7.00x the position change MEXC's own deal feed reports; …" },
      { "exchange": "Deribit", "newest_hour": "2026-11-18T22:00:00.000Z", "reason": "Its newest reading is 7 hours older than the board's last hour." }
    ],
    "venues": [
      { "exchange": "Binance", "crypto": [27610344310, "…", 26045211780], "rwa": [962331208, "…", 987512004], "ex_majors": [8120548823, "…", 7701243911] }
    ],
    "classes": [
      { "asset_class": "equity", "label": "Equities", "hourly": [6612048300, "…", 6840120011], "venues_now": [{ "exchange": "Hyperliquid", "oi": 3410228870 }] }
    ],
    "assets": [
      { "asset_id": "bitcoin", "symbol": "BTC", "asset_class": "crypto", "logo_url": "/api/coin-logo-image?symbol=BTC&resolve=coingecko&coingeckoId=bitcoin", "hourly": [24810004121, "…", 24140551029], "venues_now": [{ "exchange": "Binance", "oi": 8640120330 }] }
    ],
    "directory": [
      { "asset_id": "equity:nvda", "symbol": "NVDA", "asset_class": "equity", "logo_url": "/tradfi-logos/nvda.svg", "oi": 1180442119 }
    ],
    "btc_price": [64012.5, "…", 63336.9]
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-11-19T07:05:00Z",
    "elapsed_ms": 11
  }
}
```

For one coin's open interest by venue over time, use `GET /v1/futures/data` with `chart=oi-stacked` (see [Futures](https://docs.sharpe.ai/futures.md)).

[Read the error reference](https://docs.sharpe.ai/errors.md)


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