{"uid":"cap_NdzbZe7nix592-GLHlin9","slug":"earnings-calendar-revisions-91cf468b","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.005/call.","url":"https://www.x402financialdata.com/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_ZCcoGX630S_jH5bQekYfl","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":"What are the earnings estimates and revision trends for NVDA — I want to see the next earnings date, EPS and revenue consensus, whether analysts have been revising up or down over the last 30 days, and the last 4 quarters of actual-vs-estimate surprises.","exampleUseCases":[{"title":"Pre-earnings trade setup research","prompt":"Before TSLA reports next quarter, can you pull the earnings date, current EPS and revenue estimates, and whether Wall Street has been revising those estimates up or down over the past 30 and 60 days?"},{"title":"Earnings surprise history screen","prompt":"Show me the last 4 quarters of earnings surprises for MSFT — I want to see how much they beat or missed estimates each quarter to gauge how reliable their guidance tends to be."},{"title":"Estimate revision sentiment signal","prompt":"I'm building a watchlist and want to know if analysts have been cutting or raising their earnings estimates for AMD over the past 7, 30, 60, and 90 days — can you pull that revision trend?"}],"resultDescription":"Returns a structured payload containing: the next scheduled earnings date, consensus EPS and revenue estimates for the upcoming quarter, actual vs. estimated results for the prior 4 quarters (including surprise magnitude), and estimate revision direction indicators over 7, 30, 60, and 90-day windows — all sourced from real Yahoo Finance data.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Ticker exists but has no upcoming earnings date scheduled (e.g. ETFs, non-reporting entities)","Data temporarily unavailable from Yahoo Finance upstream source","Payment not processed — x402 payment required before data is returned","Rate limiting or timeout if called at high frequency"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive earnings intelligence snapshot for a single US stock in one call — especially when estimate revision trends (7/30/60/90-day) are important, as most earnings-calendar APIs omit this leading sentiment signal. Prefer this over generic earnings calendar APIs when you need both historical surprise data and forward estimate context together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:56.152Z","isFirstParty":false}