deribit_options_open_interest

Pack: deribit-options · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/deribit_options_open_interest for the schema, then POST the same URL with its arguments for the data.

Deribit crypto options open interest by strike for BTC or ETH, from Deribit public market data: per-strike call and put open interest for one expiry, the expiry’s total call and put open interest, the put/call open-interest ratio, and max pain, with the snapshot time. Omit expiry for the nearest expiry; a summary of every expiry (totals and ratio) comes with it. expiry accepts 20NOV26 or 2026-11-20. Honest limit: max pain is computed by Pipeworx from Deribit open interest by strike (the settlement price that minimizes total intrinsic value owed to option holders), not published by Deribit; open interest is in contracts (one contract covers one unit of the coin); live snapshot only, no history; BTC and ETH inverse options only. An expiry that is not listed returns no_match=true with the listed expiries; a failed read is an error.

Parameters

NameTypeRequiredDescription
expirystringnoExpiry as 20NOV26 or 2026-11-20. Default: the nearest listed expiry.

Example call

Arguments

{
  "currency": "BTC"
}

curl

curl -X POST https://gateway.pipeworx.io/deribit-options/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deribit_options_open_interest","arguments":{"currency":"BTC"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('deribit_options_open_interest', {
  "currency": "BTC"
});

Response shape

FieldTypeDescription
sourcestring
data_as_ofstring
currencystring
limitsstring
no_matchboolean
expirystring
expiry_datestring
underlying_price_for_expirynumber
instrumentsnumber
call_oinumber
put_oinumber
put_call_oi_rationumber
max_painobject
strikesarray
all_expiriesarray
Full JSON Schema
{
  "type": "object",
  "properties": {
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "limits": {
      "type": "string"
    },
    "no_match": {
      "type": "boolean"
    },
    "expiry": {
      "type": "string"
    },
    "expiry_date": {
      "type": "string"
    },
    "underlying_price_for_expiry": {
      "type": "number"
    },
    "instruments": {
      "type": "number"
    },
    "call_oi": {
      "type": "number"
    },
    "put_oi": {
      "type": "number"
    },
    "put_call_oi_ratio": {
      "type": "number"
    },
    "max_pain": {
      "type": "object",
      "properties": {
        "strike": {
          "type": "number"
        },
        "total_payout_usd": {
          "type": "number"
        },
        "computed_by": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "strikes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "strike": {
            "type": "number"
          },
          "call_oi": {
            "type": "number"
          },
          "put_oi": {
            "type": "number"
          }
        },
        "additionalProperties": true
      }
    },
    "all_expiries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "expiry": {
            "type": "string"
          },
          "expiry_date": {
            "type": "string"
          },
          "instruments": {
            "type": "number"
          },
          "call_oi": {
            "type": "number"
          },
          "put_oi": {
            "type": "number"
          },
          "put_call_oi_ratio": {
            "type": "number"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the deribit-options pack
{
  "mcpServers": {
    "deribit-options": {
      "url": "https://gateway.pipeworx.io/deribit-options/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 16, 2026