{"uid":"cap_6P3zYBvAIRLo0lrprCxTB","slug":"defillama-options-chain-volume-16f3eef8","name":"DefiLlama Options Chain Volume","description":"Options volumes for one chain by DefiLlama — options-protocol volume on a single chain.","url":"https://defillama.use.x402atlas.com/options-chain","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain"],"properties":{"chain":{"type":"string","pattern":"^[^/?#]+$","maxLength":100,"minLength":1,"description":"Chain slug (e.g. ethereum, arbitrum)"},"dataType":{"type":"string","maxLength":200,"description":"Optional data type (e.g. dailyPremiumVolume, dailyNotionalVolume)"},"excludeTotalDataChart":{"type":"string","maxLength":200,"description":"Optional true/false to exclude the aggregate data chart"},"excludeTotalDataChartBreakdown":{"type":"string","maxLength":200,"description":"Optional true/false to exclude the per-protocol chart breakdown"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data"],"properties":{"data":{"type":"object","properties":{"total24h":{"type":"number","description":"Aggregate 24h volume in USD, per dataType"},"protocols":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"total24h":{"type":"number"}}}}},"description":"Raw DefiLlama per-chain options overview payload","additionalProperties":true},"queried_at":{"type":"string","format":"date-time","description":"When this bridge fetched the upstream data"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"total24h":12300000,"protocols":[{"name":"Lyra","total24h":1200000}]},"queried_at":"2026-07-01T12:00:00Z"}},"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_8l-wLDI54KbOcq9qxBR5V","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 options-protocol trading volume data for a single blockchain network via DefiLlama.","exampleAgentPrompt":"Pull the daily options premium volume for Arbitrum from DefiLlama — I want to see the per-protocol breakdown but skip the aggregate chart data.","exampleUseCases":[{"title":"Options volume check on Ethereum","prompt":"Can you pull the options trading volume data for Ethereum from DefiLlama? I want to see which protocols are driving the most premium volume right now."},{"title":"Solana DeFi options market activity","prompt":"What's the current options market activity on Solana? Grab the daily premium and notional volume breakdown by protocol from DefiLlama so I can see who the major players are."},{"title":"Compare options volume across chains","prompt":"I'm trying to understand how active the options market is on Arbitrum versus other chains — can you fetch the per-protocol options volume stats for Arbitrum from DefiLlama, including the time-series chart?"}],"resultDescription":"Returns options protocol volume statistics for the specified chain, including daily premium volume, daily notional volume, an aggregate time-series chart, and a per-protocol breakdown chart. Optional flags can suppress either chart dataset.","failureModes":["Missing required 'chain' query parameter returns a 400 or validation error","Unrecognized chain slug returns empty data or 404","Payment not included or insufficient USDC results in 402 Payment Required","Network timeout or DefiLlama upstream unavailability causes 503","Invalid dataType string silently returns default data or error"],"whenToPreferThis":"Use this endpoint when you need options-specific volume data scoped to a single blockchain network, especially when you want to see per-protocol breakdowns of premium or notional volume. Prefer this over the general DEX volumes endpoint when the user is asking specifically about options/derivatives protocols rather than spot trading.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:45.569Z","isFirstParty":false}