{"uid":"cap_WWg0gmQmooCKfZSDyAoKY","slug":"defillama-options-protocol-summary-f73a702e","name":"DefiLlama Options Protocol Summary","description":"Options summary by DefiLlama — volume and history for one options protocol by slug.","url":"https://defillama.use.x402atlas.com/option-summary","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":["protocol"],"properties":{"dataType":{"type":"string","maxLength":200,"description":"Optional data type (e.g. dailyPremiumVolume, dailyNotionalVolume)"},"protocol":{"type":"string","pattern":"^[^/?#]+$","maxLength":100,"minLength":1,"description":"Options protocol slug (e.g. hegic, derive-v1 — see /defillama/options for the live list)"},"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":{"name":{"type":"string","description":"Protocol display name"},"total24h":{"type":"number","description":"24h volume in USD, per dataType"},"totalAllTime":{"type":"number","description":"All-time cumulative volume in USD"}},"description":"Raw DefiLlama options summary payload","additionalProperties":true},"queried_at":{"type":"string","format":"date-time","description":"When this bridge fetched the upstream data"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"name":"Lyra","total24h":1200000,"totalAllTime":1230000000},"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_J8dwL0Tn9gvxbxfe9AG9u","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 volume metrics and historical data for a single DeFi options protocol identified by its DefiLlama slug.","exampleAgentPrompt":"Can you pull the DefiLlama options summary for Lyra, including daily premium volume history but excluding the aggregate chart breakdown?","exampleUseCases":[{"title":"Compare options protocol volume trends","prompt":"Can you pull the historical daily premium volume for Premia from DefiLlama so I can see how their options trading activity has changed over the past few months?"},{"title":"Check notional volume for on-chain options","prompt":"I want to look up the daily notional volume history for Hegic on DefiLlama — can you fetch that and filter out the per-protocol chart series so I just get the top-level data?"},{"title":"Monitor DeFi options market activity","prompt":"Can you grab the latest options volume stats for Dopex from DefiLlama, including the historical chart data, so I can get a sense of how active their options market has been recently?"}],"resultDescription":"Returns volume and historical chart data for the specified options protocol, including metrics like daily premium volume and daily notional volume, with optional filtering to exclude aggregate or per-protocol chart series.","failureModes":["Missing required 'protocol' query parameter returns an error","Invalid or unknown protocol slug returns empty or error response","Invalid dataType string may return no data or unexpected results","Network timeout or upstream DefiLlama API unavailability causes failure","Payment of $0.005 USDC not fulfilled results in 402 response"],"whenToPreferThis":"Use this endpoint when you need detailed volume and historical data for a specific DeFi options protocol by its DefiLlama slug, as opposed to broad overviews across all protocols. Prefer this over DEX or fees endpoints when the subject is options markets specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:40.565Z","isFirstParty":false}