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, mark/bid/ask IV and greeks (delta, gamma, vega, theta, rho) for options, funding for perpetuals, and 24h stats. Send POST /api/options-ticker with no required fields (3 optional) and pay $0.002 per call over x402 or MPP (there is no free tier). It returns a JSON object with source, resolvedFrom, ticker and fetchedAt.
Pass instrument (e.g. BTC-26DEC26-100000-C or BTC-PERPETUAL), or pass currency (+ optional type call/put) to get the at-the-money option of the nearest expiry. Keyless public data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
instrument | string | no | Deribit instrument name, e.g. BTC-PERPETUAL or ETH-27MAR26-3000-P. |
currency | string | no | Alternative to instrument: BTC or ETH picks the nearest-expiry at-the-money option. |
type | string | no | With currency: call (default) or put. |
Example request
curl -i -X POST https://agent402.tools/api/options-ticker \
-H "Content-Type: application/json" \
-d '{"currency":"BTC"}'
Without payment this returns HTTP 402 Payment Required with the exact price for options-ticker; any x402 v2 or MPP client pays it and retries.
Example response
{
"source": "deribit",
"resolvedFrom": "nearest-expiry-atm",
"ticker": {
"instrument": "BTC-26AUG26-77000-C",
"state": "open",
"markPrice": 0.0121,
"lastPrice": 0.012,
"bestBid": 0.0115,
"bestAsk": 0.0125,
"indexPrice": 77242.3,
"underlyingPrice": 77317.9,
"underlyingIndex": "BTC-26AUG26",
"openInterest": 85.2,
"markIv": 47.5,
"bidIv": 46.1,
"askIv": 48.9,
"greeks": {
"delta": 0.52,
"gamma": 0.00012,
"vega": 30.1,
"theta": -190.2,
"rho": 2.1
},
"stats": {
"high24h": 0.013,
"low24h": 0.011,
"priceChange24hPct": -4.2,
"volume24h": 120.5,
"volume24hUsd": 112000
},
"timestamp": "2026-08-22T12:00:00.000Z"
},
"fetchedAt": "2026-08-22T12:00:00.000Z"
}
| Field | Type | Always present | In the example |
|---|---|---|---|
source | string | yes | deribit |
resolvedFrom | string | yes | nearest-expiry-atm |
ticker | object | yes | 16 fields: instrument, state, markPrice, lastPrice, bestBid, bestAsk |
fetchedAt | string | yes | 2026-08-22T12:00:00.000Z |
From an MCP client
catalog.call {
"slug": "options-ticker",
"params": {
"currency": "BTC"
}
}
The hosted connector at https://agent402.tools/mcp needs a payment for options-ticker; 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 (
Authorization: Bearer a402_...) also pays it. - A
GETorHEADto /api/options-ticker 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/options-ticker", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"currency": "BTC"
}),
});
Related tools
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…
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 …
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 …
Perp premium and predicted funding
POST /api/perp-basisBasis view for one perpetual: mark, oracle and mid price, mark-vs-oracle premium in percent and bps, the impact premium …
Perp dex limits and status (HIP-3)
POST /api/perp-dex-limitsRisk limits and status of ONE builder-deployed perp dex (HIP-3): total open-interest cap, per-perp OI size cap, max tran…
Perp dex markets snapshot (HIP-3)
POST /api/perp-dex-marketsSnapshot of every market on ONE builder-deployed perp dex (HIP-3): mark and oracle price, 24h change, hourly funding (pl…