{"uid":"cap_E-M5ks3sS-7vbfsjmbyTd","slug":"earnings-calendar-revisions-a7e6bd72","name":"Earnings Calendar & Revisions","description":"Earnings intelligence for a US stock in one call, not just a calendar: next earnings date with EPS/revenue estimates, the last 4 quarters' actual-vs-estimate surprises, and whether Wall Street's estimates are being revised up or down over 7/30/60/90 days -- a leading sentiment signal most earnings-calendar APIs don't offer. From real Yahoo Finance data. $0.01/call.","url":"https://x402-stock-indicators.vercel.app/earnings/:ticker","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"Stock ticker symbol, e.g. AAPL, TSLA, MSFT"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HuZvfGJ1x-cyXmUJM1LU7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns next earnings date with EPS/revenue estimates, last 4 quarters of actual-vs-estimate surprises, and estimate revision trends over 7/30/60/90 days for a US stock ticker.","exampleAgentPrompt":"Pull up the full earnings picture for NVDA — next earnings date, EPS and revenue estimates, how it's surprised over the last four quarters, and whether analyst estimates have been revised up or down recently.","exampleUseCases":[{"title":"Earnings date and estimates lookup","prompt":"When does Apple report next, and what are analysts expecting for EPS and revenue? Also show me whether estimates have been moving up or down over the last month."},{"title":"Pre-earnings sentiment check","prompt":"Before Tesla's next earnings, I want to know if Wall Street has been upgrading or downgrading their estimates over the last 30, 60, and 90 days — and pull up the last four quarters of beat or miss history too."},{"title":"Earnings surprise pattern analysis","prompt":"Show me Meta's earnings track record over the last four quarters — how much did they beat or miss estimates each time — and tell me what analysts are expecting for the upcoming report."}],"resultDescription":"Returns a structured JSON object containing: next scheduled earnings date, consensus EPS and revenue estimates, actual vs. estimated results for the last 4 quarters (including surprise magnitude), and estimate revision sentiment over 7, 30, 60, and 90-day windows — a leading indicator of Wall Street sentiment.","failureModes":["Invalid or unknown ticker symbol returns 404 or error response","Non-US or delisted tickers may return no data","Earnings date unavailable for companies that haven't scheduled yet","Yahoo Finance data outage may cause stale or missing fields","Payment failure (insufficient USDC balance) prevents call from completing"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive earnings intelligence package in a single call — combining the earnings calendar date, analyst estimates, historical surprise data, and estimate revision trends. Prefer this over plain earnings calendar APIs when you need to gauge whether sentiment is improving or deteriorating before an earnings event, or when you want to contextualize upcoming earnings with historical beat/miss patterns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:24.884Z","isFirstParty":false}