{"uid":"cap_nafGQh98GTTdf59XZhu4I","slug":"agent402-options-summary-decd2c38","name":"Agent402 Options Summary","description":"A one-call options market summary for a currency: index price, DVOL, call and put open interest with the put/call ratio, total open interest, 24h volume, a per-expiry breakdown, the most active instruments and the perp's mark, funding and open interest. Use it when an agent needs the state of BTC or ETH options before drilling into a chain.","url":"https://agent402.tools/api/options-summary","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"currency":{"type":"string","description":"BTC (default), ETH, or another Deribit currency code."}}},"responseSchema":{"type":"json","example":{"dvol":{"time":"2026-08-22T11:00:00.000Z","value":41.74},"source":"deribit","options":{"expiries":[{"expiry":"26AUG26","expiresAt":"2026-08-26T08:00:00.000Z","instruments":60,"openInterest":12000,"volume24hUsd":5000000}],"instruments":900,"volume24hUsd":900000000,"volume24hBase":12000,"putCallOiRatio":0.733,"openInterestUsd":20000000000,"putOpenInterest":110000,"callOpenInterest":150000,"topByOpenInterest":[{"type":"put","expiry":"25SEP26","markIv":62.03,"strike":120000,"instrument":"BTC-25SEP26-120000-P","openInterest":174.5,"volume24hUsd":0}],"totalOpenInterest":260000},"currency":"BTC","fetchedAt":"2026-08-22T12:00:00.000Z","perpetual":{"funding8h":0.000195,"markPrice":77263.43,"instrument":"BTC-PERPETUAL","openInterest":903679080,"volume24hUsd":664803850,"currentFunding":0.000149},"indexPrice":77232.62}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WTuiCvSa_D5qO_n9JPLd8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a structured snapshot of crypto options market data for a given currency, including open interest, volume, expiries, put/call ratios, perpetual funding, DVOL, and top instruments by open interest from Deribit.","exampleAgentPrompt":"Give me a full BTC options market summary from Deribit — open interest, 24h volume, put/call ratio, top instruments, perpetual funding rate, and the current DVOL index.","exampleUseCases":[{"title":"Volatility dashboard for BTC options","prompt":"Pull the latest BTC options summary — I want to see the DVOL index, total open interest in USD, the put/call OI ratio, and which expiries are most active."},{"title":"Funding rate and perpetual monitor","prompt":"What's the current BTC perpetual funding rate and mark price on Deribit right now? Also show me the index price alongside it."},{"title":"ETH options market snapshot","prompt":"Get me an ETH options market summary — I need the 24h volume, open interest breakdown by puts and calls, and the top instruments by open interest."}],"resultDescription":"A JSON object containing: DVOL volatility index with timestamp and value; perpetual contract details (funding rate, mark price, open interest, 24h volume); options aggregate stats (total instruments, 24h USD and base volume, total open interest in USD, put and call open interest, put/call ratio); per-expiry breakdown (instruments count, open interest, 24h volume); top instruments by open interest (type, expiry, strike, instrument name, mark IV, open interest, 24h volume); source attribution and fetchedAt timestamp.","failureModes":["Unsupported currency code returns an error or empty dataset","Deribit API unavailability causes fetch failure","Malformed request body results in a validation error","Rate limiting or payment failure (x402) blocks the call","Stale data if Deribit feed is delayed"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, pre-aggregated snapshot of a crypto options market (especially BTC or ETH) including volatility index, open interest, put/call ratios, funding rates, and top instruments — all in one call. Prefer it over raw exchange APIs when you want normalized, agent-ready data without managing Deribit authentication, and when pay-per-call via USDC (x402) is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:05.147Z","isFirstParty":false}