{"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 four-quarter history. 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","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-09-14T12:56:05.743Z","isFirstParty":false}