{"uid":"cap_-Kq_VgjR58sjKMFrLCvsG","slug":"2s-io-earnings-surprises-9e754867","name":"2s.io Earnings Surprises","description":"Historical quarterly earnings surprises for a US-listed company — reported (actual) EPS vs the analyst consensus estimate, the absolute surprise, and the surprise percentage, for the most recent quarters (newest first). Pass ticker (optionally limit). Tells you whether a company has been beating or missing expectations. Data by Finnhub.","url":"https://2s.io/api/stocks/earnings-surprises?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","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker, e.g. AAPL."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"ticker":"AAPL"}}},"response":{"data":{"ok":true,"meta":{"symbol":"AAPL"},"items":[{"year":2026,"actual":2.01,"period":"2026-03-31","quarter":2,"estimate":1.9884,"surprise":0.0216,"surprisePercent":1.0863},{"year":2026,"actual":2.84,"period":"2025-12-31","quarter":1,"estimate":2.7257,"surprise":0.1143,"surprisePercent":4.1934},{"year":2025,"actual":1.85,"period":"2025-09-30","quarter":4,"estimate":1.8075,"surprise":0.0425,"surprisePercent":2.3513},{"year":2025,"actual":1.57,"period":"2025-06-30","quarter":3,"estimate":1.4626,"surprise":0.1074,"surprisePercent":7.3431}],"total":4,"source":{"url":"https://finnhub.io","license":"Finnhub API terms (commercial market, fundamental & alternative data; attribution required)","provider":"Finnhub"}},"meta":{"cost":{"usd":0.001},"caller":"x402","version":null,"endpoint":"stocks.earnings-surprises","settlement":{"txHash":"0x9285a7dc856d5019cb182657d86a8e3d7511b1077ac24effebc455cd27f8bdb2","network":"eip155:8453","success":true}}}},"exampleRequest":{"ticker":"AAPL"},"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KMRfZKGKu9QXmyDjHSijy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical quarterly EPS earnings surprises for a US-listed stock, showing actual vs consensus analyst estimate, absolute surprise, and surprise percentage (newest first).","exampleAgentPrompt":"Has NVDA been beating or missing analyst earnings expectations recently? Show me the actual vs consensus EPS and the surprise percentage for the last few quarters.","exampleUseCases":null,"resultDescription":"A list of quarterly records (newest first) each containing: the quarter date, the reported (actual) EPS, the analyst consensus EPS estimate, the absolute EPS surprise (actual minus estimate), and the surprise percentage — indicating whether the company beat or missed expectations that quarter.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Non-US-listed tickers may not be supported","Data may lag by a few days after earnings release","Network or upstream Finnhub API outage returns a 5xx error","Missing required 'ticker' query parameter returns a 400 error"],"whenToPreferThis":"Use this endpoint when you need historical EPS beat/miss data for a US-listed company to evaluate earnings quality, consistency, or analyst forecast accuracy. Prefer this over general financial data endpoints when the specific goal is comparing actual vs consensus EPS across recent quarters. Complements the sibling XBRL financials endpoint which covers broader accounting metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:52:01.945Z","isFirstParty":false,"canonicalSlug":"2s-io-earnings-surprises-9e754867"}