{"uid":"cap_-SyOmK2I5wZcFFJePctnl","slug":"otto-ai-earnings-calendar-bfefad94","name":"Otto AI Earnings Calendar","description":"Earnings calendar and surprise history for a vendor-resolved equity: next report date/session with EPS and revenue estimates, latest reported EPS versus estimate, surprise percentage, and up to four quarters of history, which may be fewer. Monetary estimates retain Finnhub payload units because the captured feed does not identify a currency. Event-window price drift is explicitly unavailable rather than inferred.","url":"https://x402.ottoai.services/earnings-calendar?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":["ticker"],"properties":{"ticker":{"type":"string","description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use the vendor payload units and are not relabeled as USD."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status"],"properties":{"data":{},"meta":{"type":"object"},"reason":{"type":"string","description":"status=unavailable only; every >=400 is UNCHARGED"},"status":{"enum":["success","unavailable"],"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"ticker":"AAPL","provider":"Finnhub","lastEarnings":{"result":"beat","epsBasis":"vendor-reported","epsSurprisePct":1.09},"nextEarnings":{"session":"after-market-close","reportDate":"2026-07-30","epsEstimate":1.93},"prePostPriceDrift":{"status":"unavailable"}},"meta":{"degraded":false,"validUntil":"","generatedAt":"","stalenessSec":0},"status":"success"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VCa0b0YawCuTCfFM052-u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming and past earnings data for an equity or ETF ticker, including EPS estimates, report dates, session timing, and surprise results.","exampleAgentPrompt":"When is Apple's next earnings report and what's the EPS estimate? Also tell me if they beat or missed last quarter.","exampleUseCases":[{"title":"Pre-earnings trade preparation","prompt":"Pull up NVDA's earnings calendar — I want to know when they're reporting next, whether it's before or after market close, and what the EPS estimate is so I can decide on a position."},{"title":"Post-earnings surprise analysis","prompt":"Did Tesla beat or miss earnings last quarter? I want to see the EPS surprise percentage and when the fiscal period ended."},{"title":"Earnings date monitoring for portfolio","prompt":"Check the earnings calendar for SPY — I need the next report date and the EPS estimate so I know when to expect volatility."}],"resultDescription":"Returns a JSON object with the ticker, data provider (Finnhub), last earnings details (result beat/miss, EPS surprise %, fiscal period end), next earnings details (report date, session timing like after-market-close, EPS estimate), and metadata including freshness timestamp and staleness in seconds.","failureModes":["Unsupported ticker symbol returns an error or empty data payload","ETFs with no earnings calendar (e.g. broad index ETFs) may return unavailable fields","Pre/post price drift status may be returned as 'unavailable' when data is not available","Stale data if cache has not refreshed — check meta.stalenessSec and meta.validUntil","Missing or malformed ticker query parameter returns a validation error"],"whenToPreferThis":"Use this endpoint when you need structured earnings calendar data for a specific US equity or ETF ticker, including both historical EPS surprise results and upcoming report dates with session timing. Prefer this over generic financial data APIs when you need a single clean pay-per-call lookup without a subscription, especially within an AI agent workflow that already handles x402 micropayments on Base, Polygon, or Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:34:56.747Z","isFirstParty":false,"canonicalSlug":"otto-ai-earnings-calendar-bfefad94"}