{"uid":"cap_IonUJXLiBYvSE5xh_-sW-","slug":"agent402-options-volume-by-protocol-11feb697","name":"Agent402 Options Volume by Protocol","description":"Onchain options protocols ranked by 24h notional volume with 7d and 30d volume, 1d and 7d change and the chains each runs on, plus sector totals. Use it when an agent is comparing decentralized options venues or tracking whether onchain options activity is growing.","url":"https://agent402.tools/api/options-volume","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Optional chain name filter, e.g. Arbitrum (case-insensitive)."},"limit":{"type":"number","description":"Protocols to return (default 25, max 100)."}}},"responseSchema":{"type":"json","example":{"count":1,"chains":["Derive Chain","Hyperliquid L1","Base"],"source":"defillama-options","totals":{"change1dPct":10.03,"change7dPct":4.1,"volume7dUsd":11148265.31,"volume24hUsd":5093016,"volume30dUsd":30971390.66},"fetchedAt":"2026-08-22T12:00:00.000Z","protocols":[{"name":"Derive","slug":"derive","chains":["Derive Chain"],"category":"Options","change1dPct":12.5,"change7dPct":3.2,"volume7dUsd":7000000,"volume24hUsd":3000000,"volume30dUsd":20000000}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UyweAkShwv2mfdw8FHXuR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns DeFi options trading volume data across protocols and chains, including 24h, 7d, and 30d volume figures with percentage changes.","exampleAgentPrompt":"What are the top 10 DeFi options protocols by trading volume right now, filtered to Arbitrum?","exampleUseCases":[{"title":"Daily DeFi options market briefing","prompt":"Give me a rundown of the top 25 on-chain options protocols by 24-hour volume — I want to see which ones are gaining or losing momentum today."},{"title":"Chain-specific options research","prompt":"Show me all the DeFi options protocols active on Hyperliquid and their 7-day and 30-day volume figures so I can compare them."},{"title":"Spot surging options venues","prompt":"Which DeFi options platforms had the biggest 1-day volume percentage increase? Pull the top 10 so I can identify what's moving."}],"resultDescription":"A JSON object containing the total count of protocols returned, a list of active chains, the data source (DefiLlama), aggregate volume totals (24h, 7d, 30d USD) with 1d and 7d percentage changes, the fetch timestamp, and an array of individual protocol records each with name, slug, chains, category, and volume metrics.","failureModes":["Invalid chain name returns empty protocol list or zero results","Limit exceeding 100 is clamped or returns an error","Data may lag real-time by the DefiLlama refresh interval","Malformed request body returns a 400-level error","Network or upstream DefiLlama outage causes fetch failure"],"whenToPreferThis":"Use this endpoint when you need structured, multi-period options trading volume data across DeFi protocols — especially when you want chain-level filtering (e.g. only Arbitrum or Base) or ranked protocol lists. Prefer it over general DeFi data APIs when options-specific volume metrics (24h/7d/30d) and change percentages are the primary need. It is more targeted than a broad DeFi analytics query and cheaper than a full DefiLlama API integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:15.779Z","isFirstParty":false}