# Open Interest by Exchange (OI)

> Open Interest by Exchange (OI) is a paid API for AI agents from derivs.duoleads.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-15).

Returns per-exchange open interest for a crypto perpetual futures coin, including USD and coin-denominated OI, market share percentages, and 1h/4h/24h change metrics across up to 8 exchanges.

## Facts

- Endpoint: GET https://derivs.duoleads.com/v1/open-interest?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/open-interest-by-exchange-oi-8709e4d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pAmAA3UjdPqzse6a890un

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability open-interest-by-exchange-oi-8709e4d3
```

Example prompt: What's the current open interest for BTC broken down by exchange — I want to see which venues like Bybit, Hyperliquid, and OKX have the most, and how it's changed over the last 24 hours.

## When to prefer this

Use this endpoint when you need a cross-exchange view of perpetual futures open interest for a specific coin, including market share and momentum (1h/4h/24h changes). Prefer this over single-exchange APIs when comparing how OI is distributed across Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, and OKX simultaneously. Requires no API key — pay per call with USDC on Base via x402.

## Known failure modes

- Missing or invalid coin symbol returns an error — coin must be a non-empty string up to 32 characters
- Unknown coin symbols not traded as perps on supported exchanges may return empty venue lists
- Payment failure via x402/USDC on Base will block the request
- Stale data from an exchange is flagged in the venues array but still returned
- venues_missing array lists any exchanges that failed to return data for that call

## How this service works

Perp funding rates, open interest, futures basis, implied volatility, liquidations, order book depth and a perp screener for crypto perpetual futures across 8 exchanges (Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX), paid per call over x402 with USDC on Base. No account, no API key.

## Output

Returns a JSON object containing: total OI in USD and coins across all venues, a per-venue breakdown with USD OI, coin OI, symbols traded, and market share percentage, plus a change array showing 1h/4h/24h percent changes per venue. Also includes metadata like staleness flags, data timestamp, and a see_also hint linking to liquidations if OI is falling.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "maxLength": 32,
       "minLength": 1,
       "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "colo": null,
  "as_of": "2026-10-14T23:00:00Z",
  "units": {
   "times": "ISO 8601 UTC",
   "oi_usd": "USD (OI x mark price)",
   "oi_coins": "coins (one side of the book), all perpetuals of the coin on the venue",
   "share_pct": "percent of the total oi_usd",
   "change_pct": "percent change of the venue's own OI series (unit in `unit`)"
  },
  "change": [
   {
    "unit": "coins",
    "as_of": "2026-10-14T23:00:00Z",
    "venue": "bybit",
    "latest": 30086.085,
    "symbol": "BTCUSDT",
    "latest_time": "2026-10-14T22:00:00Z",
    "change_1h_pct": 0.645335,
    "change_4h_pct": 1.4056,
    "change_24h_pct": 7.46048
   },
   {
    "unit": "usd",
    "as_of": "2026-10-14T23:00:00Z",
    "venue": "gate",
    "latest": 4343972013,
    "symbol": "BTC_USDT",
    "latest_time": "2026-10-14T22:00:00Z",
    "change_1h_pct": -0.00334619,
    "change_4h_pct": -0.0314464,
    "change_24h_pct": 1.28509
   }
  ],
  "venues": [
   {
    "as_of": "2026-10-14T23:00:00Z",
    "stale": false,
    "venue": "gate",
    "oi_usd": 4344915053,
    "symbols": [
     "BTC_USDT"
    ],
    "oi_coins": 53224.3312,
    "share_pct": 28.2208
   },
   {
    "as_of": "2026-10-14T23:00:00Z",
    "stale": false,
    "venue": "hyperliquid",
    "oi_usd": 3279501531,
    "symbols": [
     "BTC"
    ],
    "oi_coins": 40178.15264,
    "share_pct": 21.3008
   },
   {
    "as_of": "2026-10-14T23:00:00Z",
    "stale": false,
    "venue": "okx",
    "oi_usd": 3168502615,
    "symbols": [
     "BTC-USD-SWAP",
     "BTC-USDT-SWAP"
    ],
    "oi_coins": 38822.6842,
    "share_pct": 20.5799
   }
  ],
  "see_also": {
   "params": [
    "coin",
    "hours"
   ],
   "reason": "Open interest falling? See the recent long and short liquidations per venue.",
   "endpoint": "https://derivs.duoleads.com/v1/liquidations"
  },
  "disclaimer": "Data only, not investment advice, not a benchmark; not affiliated with any exchange",
  "request_id": "01KEXAMPLE0000000000000000",
  "total_oi_usd": 15396127720,
  "total_oi_coins": 188622.1742,
  "venues_missing": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/open-interest-by-exchange-oi-8709e4d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from derivs.duoleads.com](https://www.zero.xyz/host/derivs.duoleads.com/llms.txt)