Skip to main content
GET
/
gex
/
term-oi
/
{exchange}
/
{coin}
curl https://api.gammaflip.io/api/v1/gex/term-oi/all/BTC \
  -H "X-API-Key: gex_sk_your_key_here"

{
  "data": {
    "expirations": [
      {
        "date": "25APR26",
        "total_gex": 142857000,
        "total_oi": 12543,
        "by_exchange": {
          "bybit": { "gex": 42857000, "oi": 4200 },
          "deribit": { "gex": 100000000, "oi": 8343 }
        }
      }
    ]
  },
  "meta": {
    "timestamp": "2026-04-14T10:00:00+00:00",
    "exchange": "all",
    "coin": "BTC",
    "rate_limit": {
      "limit": 500,
      "remaining": 494,
      "reset": "2026-04-15T00:00:00+00:00"
    }
  }
}

​
What it returns

For each expiration date, this endpoint returns:
  • Open Interest (total contracts outstanding) per exchange
  • Gamma Exposure (total dealer gamma, in dollar terms) per exchange
  • Aggregated totals across all exchanges
Use this to understand how gamma and OI are distributed across the term structure, and to spot the expirations where dealer positioning is heaviest.

​
Path parameters

​
exchange
string
required
Exchange name: bybit, deribit, okx, or all (cross-exchange aggregation).
​
coin
string
required
Base coin symbol (uppercase).

​
Response schema

The response data follows the schema used internally by the GammaFlip dashboard. Shape at a glance: 
{
  "data": {
    "expirations": [
      {
        "date": "25APR26",
        "total_gex": 1234567890,
        "total_oi": 45678,
        "by_exchange": {
          "bybit": { "gex": ..., "oi": ... },
          "deribit": { "gex": ..., "oi": ... }
        }
      }
    ],
    "metadata": { ... }
  }
}
The exact structure may include additional fields (puts/calls breakdown, notional values, etc.). Treat undocumented fields as stable but unversioned — we won’t remove them without notice, but new fields may be added.

​
Errors

​
400 invalid_exchange
error
Exchange name not recognized.
​
404 no_data
error
No data available for this coin/exchange combination.
curl https://api.gammaflip.io/api/v1/gex/term-oi/all/BTC \
  -H "X-API-Key: gex_sk_your_key_here"

{
  "data": {
    "expirations": [
      {
        "date": "25APR26",
        "total_gex": 142857000,
        "total_oi": 12543,
        "by_exchange": {
          "bybit": { "gex": 42857000, "oi": 4200 },
          "deribit": { "gex": 100000000, "oi": 8343 }
        }
      }
    ]
  },
  "meta": {
    "timestamp": "2026-04-14T10:00:00+00:00",
    "exchange": "all",
    "coin": "BTC",
    "rate_limit": {
      "limit": 500,
      "remaining": 494,
      "reset": "2026-04-15T00:00:00+00:00"
    }
  }
}