{"uid":"cap_rohlqrV8IuUOvmOCmk8qK","slug":"gloom-options-volatility-surfaces-api-85d3b8ba","name":"Gloom Options Volatility Surfaces API","description":"Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.","url":"https://api.gloom.sh/v1/options/surfaces?utm_source=zero.xyz","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":["symbols"],"properties":{"symbols":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"spot":774.95,"symbol":"AAPL","surface":{"spot":774.95,"source":"gloom","symbol":"SPY","version":1,"expiries":[{}],"failures":[],"spotAsOf":"2026-10-08T16:46:00.000Z","capturedAt":"2026-10-08T16:55:20.000Z"},"capturedAt":"2026-10-08T16:55:20.000Z","sessionDate":"2026-10-08"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.5","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":"$1.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o3P04jqU0RQ1lbOx2RHSe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches implied volatility surfaces for one or more equity/ETF ticker symbols, returning spot price, expiry ladder, and surface data captured at market close.","exampleAgentPrompt":"Pull the current implied volatility surface for AAPL and SPY from Gloom so I can see the full expiry ladder and spot prices.","exampleUseCases":[{"title":"Options pricing model calibration","prompt":"Get me the current implied volatility surface for SPY and QQQ from Gloom — I need the full expiry structure and spot prices to calibrate my pricing model."},{"title":"Portfolio hedging analysis","prompt":"Fetch the IV surfaces for TSLA and NVDA from Gloom right now, including all expiries, so I can figure out the best strikes to hedge my long positions."},{"title":"Intraday vol monitoring for traders","prompt":"Pull the latest options volatility surfaces for AAPL, MSFT, and AMZN from Gloom — I want to see where implied vol is sitting across the term structure today."}],"resultDescription":"Returns an array of objects per requested symbol, each containing: the current spot price, the full implied volatility surface object (with source, version, expiry ladder, spot-as-of timestamp, and capture timestamp), session date, and any surface computation failures. Data reflects the most recently captured market session.","failureModes":["Invalid or unrecognized ticker symbol returns missing or empty surface data","Market closed or no recent session may return stale capturedAt timestamps","Missing required 'symbols' query parameter results in a 400-level error","Symbol with no options market (e.g. OTC stocks) may return empty expiries array","Rate limiting or payment failure (x402) results in 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need structured implied volatility surface data — including full expiry ladders and spot prices — for equity options analysis, derivatives pricing, or hedging workflows. Prefer it over generic market data APIs when you specifically need the vol surface (not just option quotes or Greeks), and when working with Gloom's finance terminal ecosystem. Best suited for quantitative finance agents doing model calibration, vol monitoring, or risk analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:41.080Z","isFirstParty":false,"canonicalSlug":"gloom-options-volatility-surfaces-api-85d3b8ba"}