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
| Name | Type | Required | Description |
|---|---|---|---|
expiry | string | no | Expiry 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
| Field | Type | Description |
|---|---|---|
source | string | |
data_as_of | string | |
currency | string | |
limits | string | |
no_match | boolean | |
expiry | string | |
expiry_date | string | |
underlying_price_for_expiry | number | |
instruments | number | |
call_oi | number | |
put_oi | number | |
put_call_oi_ratio | number | |
max_pain | object | |
strikes | array | |
all_expiries | array |
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.