{"uid":"cap_o5D148asB3Cyi7XlmJj7U","slug":"the-stall-earnings-surprises-f88f6731","name":"The Stall — Earnings Surprises","description":"Historical EPS beat/miss data for any US equity: actual EPS, consensus estimate, surprise %, beat rate, estimate revisions (30-day EPS drift), and next earnings date. Free Yahoo Finance data, no API key. Pairs with analyst-ratings and equity-fundamentals for a complete earnings intelligence stack.","url":"https://the-stall.intuitek.ai/cap/earnings-surprises","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ticker":"AAPL","quarters":4}}},"response":{"ts":"2026-06-21T05:20:10.203Z","name":"Apple Inc.","annual":[{"year":2025,"revenue_usd":416161000000,"net_income_usd":112010000000,"profit_margin_pct":26.92},{"year":2024,"revenue_usd":391035000000,"net_income_usd":93736000000,"profit_margin_pct":23.97},{"year":2023,"revenue_usd":383285000000,"net_income_usd":96995000000,"profit_margin_pct":25.31},{"year":2022,"revenue_usd":394328000000,"net_income_usd":99803000000,"profit_margin_pct":25.31}],"ticker":"AAPL","quarterly":[{"period":"1Q2026","actual_eps":2.01,"estimate_eps":1.94,"surprise_pct":3.46,"reported_date":"2026-04-30","fiscal_quarter":"2Q2026","period_end_date":"2026-03-31"},{"period":"4Q2025","actual_eps":2.84,"estimate_eps":2.67,"surprise_pct":6.34,"reported_date":"2026-01-29","fiscal_quarter":"1Q2026","period_end_date":"2025-12-31"},{"period":"3Q2025","actual_eps":1.85,"estimate_eps":1.77,"surprise_pct":4.52,"reported_date":"2025-10-30","fiscal_quarter":"4Q2025","period_end_date":"2025-09-30"},{"period":"2Q2025","actual_eps":1.57,"estimate_eps":1.43,"surprise_pct":10.12,"reported_date":"2025-07-31","fiscal_quarter":"3Q2025","period_end_date":"2025-06-30"}],"beat_rate_pct":100,"avg_surprise_pct":6.11,"next_earnings_date":"2026-07-30","current_quarter_estimate":1.89,"estimate_revision_30d_pct":-0.06}},"exampleRequest":{"ticker":"AAPL","quarters":4},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.099","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.099","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vy3TWAjXgXpk9VDa4WExv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.099","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical earnings surprise data (EPS estimates vs actuals) for a given US stock ticker over up to 8 past quarters","exampleAgentPrompt":"Pull the earnings surprise history for NVDA — how much did they beat or miss EPS estimates over the last 8 quarters?","exampleUseCases":[{"title":"Identify consistent earnings beat stocks","prompt":"Show me which of our tech holdings have beaten analyst expectations consistently over the last year. I want to focus on companies with a track record of positive earnings surprises."},{"title":"Screen for earnings momentum signals","prompt":"Pull the earnings surprise data for the S&P 500 constituents I'm tracking. I need to see which ones have accelerating beats quarter over quarter — that's a bullish signal for me."},{"title":"Due diligence on acquisition target","prompt":"We're considering acquiring this company with ticker XYZ. Can you get me their full earnings surprise history for the last two years so I can assess management's ability to hit guidance?"}],"resultDescription":"Returns a list of quarterly earnings records for the requested ticker, each containing the fiscal quarter, analyst consensus EPS estimate, actual reported EPS, and the surprise amount or percentage. Covers up to 8 trailing quarters depending on the requested range.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","quarters parameter out of range (less than 1 or more than 8) may return a validation error","Payment not processed (402 response if USDC payment on Base mainnet fails)","Ticker with no earnings history (e.g. newly listed company) may return empty data","Non-US tickers may not be supported"],"whenToPreferThis":"Use this endpoint when you need historical earnings surprise data (EPS estimate vs actual) for a specific US-listed stock. Ideal for fundamental analysis workflows, screening stocks with consistent earnings beats, or building earnings momentum signals. Prefer this over general financial data endpoints when you specifically need structured surprise deltas per quarter, not just raw EPS figures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:55:31.905Z","isFirstParty":false}