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": "15APR26",
        "days_to_expiry": 0,
        "timestamp": "2026-04-15T00:00:00+00:00",
        "exchanges": {
          "deribit": {
            "oi_usd": 252323000,
            "call_oi_usd": 115940056,
            "put_oi_usd": 136382943,
            "contracts": 104,
            "total_gex": -2481405,
            "abs_gex": 23314299,
            "upside_gex": 8007918,
            "downside_gex": 15306380
          }
        },
        "total": {
          "oi_usd": 252323000,
          "call_oi_usd": 115940056,
          "put_oi_usd": 136382943,
          "contracts": 104,
          "total_gex": -2481405,
          "abs_gex": 23314299,
          "upside_gex": 8007918,
          "downside_gex": 15306380
        }
      }
    ],
    "metadata": {
      "basecoin": "BTC",
      "exchanges_used": ["deribit"],
      "current_price": 74037.30,
      "expiration_count": 11
    }
  },
  "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"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gammaflip.io/llms.txt

Use this file to discover all available pages before exploring further.

​
What it returns

For each non-expired expiration, this endpoint returns:
  • Open Interest in USD (calls, puts, and total) per exchange
  • Gamma Exposure (total, upside, downside, absolute) per exchange
  • Contract count per exchange
  • Aggregated totals across all requested exchanges
  • Per-expiration metadata — date, days to expiry, timestamp
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 shape

{
  "data": {
    "expirations": [
      {
        "date": "15APR26",
        "days_to_expiry": 0,
        "timestamp": "2026-04-15T00:00:00+00:00",
        "exchanges": {
          "deribit": {
            "oi_usd": 252323000.06,
            "call_oi_usd": 115940056.62,
            "put_oi_usd": 136382943.44,
            "contracts": 104,
            "total_gex": -2481405.91,
            "abs_gex": 23314299.33,
            "upside_gex": 8007918.34,
            "downside_gex": 15306380.99
          }
        },
        "total": {
          "oi_usd": 252323000.06,
          "call_oi_usd": 115940056.62,
          "put_oi_usd": 136382943.44,
          "contracts": 104,
          "total_gex": -2481405.91,
          "abs_gex": 23314299.33,
          "upside_gex": 8007918.34,
          "downside_gex": 15306380.99
        }
      }
    ],
    "metadata": {
      "basecoin": "BTC",
      "exchanges_used": ["deribit"],
      "current_price": 74037.30,
      "expiration_count": 11,
      "timestamp": "2026-04-14T22:43:30.035178+00:00",
      "timestamp_ms": 1776206610035
    }
  }
}

​
Per-expiration field guide

Each entry in exchanges.* and total contains the same metric set:
FieldMeaning
oi_usdTotal open interest, USD notional
call_oi_usdOpen interest contributed by call options, USD
put_oi_usdOpen interest contributed by put options, USD
contractsNumber of option contracts (not USD)
total_gexNet dealer gamma exposure (calls – puts), USD per 1% move
abs_gexAbsolute GEX magnitude — `call_gex+put_gex`
upside_gexGEX concentrated above spot
downside_gexGEX concentrated below spot
total holds the aggregate across all exchanges included in the response. When querying a single exchange (e.g. deribit), exchanges.deribit and total are identical.

​
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": "15APR26",
        "days_to_expiry": 0,
        "timestamp": "2026-04-15T00:00:00+00:00",
        "exchanges": {
          "deribit": {
            "oi_usd": 252323000,
            "call_oi_usd": 115940056,
            "put_oi_usd": 136382943,
            "contracts": 104,
            "total_gex": -2481405,
            "abs_gex": 23314299,
            "upside_gex": 8007918,
            "downside_gex": 15306380
          }
        },
        "total": {
          "oi_usd": 252323000,
          "call_oi_usd": 115940056,
          "put_oi_usd": 136382943,
          "contracts": 104,
          "total_gex": -2481405,
          "abs_gex": 23314299,
          "upside_gex": 8007918,
          "downside_gex": 15306380
        }
      }
    ],
    "metadata": {
      "basecoin": "BTC",
      "exchanges_used": ["deribit"],
      "current_price": 74037.30,
      "expiration_count": 11
    }
  },
  "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"
    }
  }
}