# ByKaranteli Options OI By Strike History

> ByKaranteli Options OI By Strike History is a paid API for AI agents from bykaranteli.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Returns daily listed options open interest history per instrument, broken down by strike, expiry, option type, implied volatility, underlying price, and traded notional.

## Facts

- Endpoint: GET https://bykaranteli.com/api/x402/options-oi-history?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bykaranteli-options-oi-by-strike-history-348742e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uvFm7tgVooXC2VCKmPhyr

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 bykaranteli-options-oi-by-strike-history-348742e1
```

Example prompt: Pull the daily options open interest history for BTC broken down by strike and expiry from January 1 to March 31 2025, up to 500 rows, so I can see where OI was concentrated and what the mark IV was at each level.

## When to prefer this

Choose this endpoint when you need granular, strike-level options open interest history with accompanying implied volatility and notional data for crypto assets. It is the right choice for vol surface analysis, max pain calculations, gamma exposure modeling, or studying how options positioning evolved over time at specific strikes and expiries. Prefer it over aggregate OI endpoints when strike-level detail matters, and over the IV index endpoint when you need per-strike breakdown rather than a single daily index value.

## Known failure modes

- No rows returned if symbol or date range has no data coverage
- Limit parameter capped at dataset maximum regardless of requested value
- Invalid or unsupported symbol returns empty rows or error
- Missing required query parameters may return generic error or empty result
- Rate limiting or payment failure returns 402 or access denied error

## How this service works

Daily listed options open interest per instrument: strike, expiry, option type, open interest, mark implied volatility, underlying price and traded notional. History from 2026-08-06 (rolling window; rows before that date do not exist).

## Output

Returns a JSON object with ok status, a dataset label ('options-oi-history'), a count of rows returned, and a rows array where each entry contains the instrument's strike price, expiry date, option type (call/put), open interest quantity, mark implied volatility, underlying spot price at time of snapshot, and traded notional — all at daily granularity.

## 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",
     "properties": {
      "to": {
       "type": "string",
       "description": "date, optional"
      },
      "from": {
       "type": "string",
       "description": "date, optional"
      },
      "limit": {
       "type": "number",
       "description": "number, optional, max 20000"
      },
      "venue": {
       "type": "string",
       "description": "string, optional options venue: deribit | bybit | binance | okx | delta"
      },
      "currency": {
       "type": "string",
       "description": "string, optional BTC or ETH"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [],
  "count": 500,
  "dataset": "options-oi-history"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bykaranteli-options-oi-by-strike-history-348742e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bykaranteli.com](https://www.zero.xyz/host/bykaranteli.com/llms.txt)