{"uid":"cap_qAxZyGsq3dRDvxET397JX","slug":"x402stock-options-aggregates-fb683b9b","name":"x402stock Options Aggregates","description":"Market and economic data for AI agents — US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities (crude, natural gas, gasoline), US and global macro (Fed funds, CPI/PCE, jobs, GDP, Treasury debt & yields, World Bank indicators), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 or MPP. This server is a pay-per-use, transparent proxy in front of x402stock's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","url":"https://agents.x402stock.xyz/api/v1/options-aggregates/%7Bcontract%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6cjPKolU3ttHdeSXvqdJX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves aggregated options market data for a specific US options contract, including pricing and related metrics, payable per-request in USDC via x402.","exampleAgentPrompt":"Pull the aggregated options data for the AAPL 2025-01-17 $200 call contract from x402stock so I can see the implied volatility, open interest, and volume right now.","exampleUseCases":[{"title":"Options contract IV and OI snapshot","prompt":"What's the current implied volatility and open interest for the SPY 2025-03-21 $580 put contract?"},{"title":"Real-time options pricing for trading bot","prompt":"Fetch the aggregated options metrics for QQQ 2025-06-20 $500 call — I need premium, volume, and open interest for my trading algorithm."},{"title":"Options research before earnings","prompt":"Can you pull the aggregated options data for TSLA's $250 call expiring this Friday so I can see how the market is pricing the earnings move?"}],"resultDescription":"Returns aggregated options market data for the specified contract, typically including fields such as implied volatility, open interest, trading volume, bid/ask prices, and contract premium. Data is returned as structured JSON for agent consumption.","failureModes":["Invalid or malformed contract identifier returns an error","Contract not found or not supported in catalog returns 404","Payment failure or insufficient USDC balance blocks the request","Expired contracts may return no data or an error","Rate limiting or service unavailability returns 5xx"],"whenToPreferThis":"Choose this endpoint when you need aggregated options data for a specific US options contract (stock or ETF) and want a pay-per-use model with no API key setup. Ideal for AI agents that need on-demand options metrics (IV, OI, volume, premium) for individual contracts. Prefer over subscription-based alternatives when usage is sporadic or when USDC micropayment autonomy is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:49:06.994Z","isFirstParty":false,"canonicalSlug":"x402stock-options-aggregates-fb683b9b"}