Options chain by expiry
POST /api/crypto-options-chainOptions chain for a currency and expiry on Deribit, sorted by strike: instrument, strike, call/put, bid, ask, mark, mark IV, open interest, 24h volume and underlying price for each listed option, plus the list of available expiries. Send POST /api/crypto-options-chain with no required fields (4 optional) and pay $0.004 per call over x402 or MPP (there is no free tier). It returns a JSON object with source, currency, expiry, expiresAt, underlyingPrice and 4 more.
Omit expiry to get the nearest one; pass type call or put to filter one side. limit caps rows (default 100, max 500). Keyless public data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
currency | string | no | BTC (default) or ETH. |
expiry | string | no | Deribit expiry label like 26DEC26; omit for the nearest expiry. |
type | string | no | Optional: call or put. |
limit | number | no | Rows to return (default 100, max 500). |
Example request
curl -i -X POST https://agent402.tools/api/crypto-options-chain \
-H "Content-Type: application/json" \
-d '{"currency":"BTC","limit":20}'
Without payment this returns HTTP 402 Payment Required with the exact price for crypto-options-chain; any x402 v2 or MPP client pays it and retries.
Example response
{
"source": "deribit",
"currency": "BTC",
"expiry": "26AUG26",
"expiresAt": "2026-08-26T08:00:00.000Z",
"underlyingPrice": 77317.9,
"expiries": [
"26AUG26",
"27AUG26",
"25SEP26"
],
"count": 2,
"options": [
{
"instrument": "BTC-26AUG26-80000-C",
"expiry": "26AUG26",
"strike": 80000,
"type": "call",
"bid": 0.0065,
"ask": 0.008,
"mark": 0.0073,
"markIv": 48.03,
"openInterest": 12.5,
"volume24h": 3.1,
"volume24hUsd": 1800,
"underlyingPrice": 77317.9
}
],
"fetchedAt": "2026-08-22T12:00:00.000Z"
}
| Field | Type | Always present | In the example |
|---|---|---|---|
source | string | yes | deribit |
currency | string | yes | BTC |
expiry | string | yes | 26AUG26 |
expiresAt | string | yes | 2026-08-26T08:00:00.000Z |
underlyingPrice | number | yes | 77317.9 |
expiries | array of string | yes | 3 items in the example |
count | number | yes | 2 |
options | array of objects | yes | 1 item in the example |
fetchedAt | string | yes | 2026-08-22T12:00:00.000Z |
From an MCP client
catalog.call {
"slug": "crypto-options-chain",
"params": {
"currency": "BTC",
"limit": 20
}
}
The hosted connector at https://agent402.tools/mcp needs a payment for crypto-options-chain; the stdio package pays it from a wallet or from AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.
Errors and behavior
- Every field is optional. An input the tool rejects returns an HTTP 4xx whose body carries
error,tool,expected,requiredandexample. - A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement is cancelled when the tool fails. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - A
GETorHEADto /api/crypto-options-chain returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
client.setSpendControls?.(false); // keep your own spending ceiling in code
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/crypto-options-chain", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"currency": "BTC",
"limit": 20
}),
});
Related tools
Options market summary
POST /api/options-summaryOne-call options market summary for a currency on Deribit: index price, the DVOL implied-volatility index, call and put …
Options instrument ticker
POST /api/options-tickerLive ticker for one Deribit instrument: mark, last, best bid/ask with sizes, index and underlying price, open interest, …
Crypto technical indicators
POST /api/crypto-indicatorsTechnical indicators for one perpetual computed deterministically from Hyperliquid candles: RSI(14), MACD(12,26,9) with …
Crypto news headlines
POST /api/crypto-newsLatest crypto headlines aggregated from the public RSS/Atom feeds of 8 major outlets (coindesk, cointelegraph, decrypt, …
Onchain options volume by protocol
POST /api/options-volumeOnchain options protocols ranked by 24h notional volume from DefiLlama's options overview: per-protocol 24h, 7d and 30d …
Wallet token transfers (filtered)
POST /api/asset-transfersRecent token transfers for a wallet on Base, Ethereum and other EVM chains, newest first. Filtered transfer log for an E…