{"uid":"cap_spf3D-a9CNR5GrE8eLAHj","slug":"tickersfeed-earnings-history-api-b41e518b","name":"TickersFeed Earnings History API","description":"Earnings history for any US stock — last 4 quarters with actual vs estimate EPS, surprise, and surprise percent. Covers NYSE, NASDAQ, AMEX. $0.003 USDC per call.","url":"https://api.tickersfeed.net/stock/NVDA/earnings?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Stock ticker symbol (e.g. AAPL, MSFT)"}}},"responseSchema":{"symbol":"AAPL","earnings":[{"actual":1.64,"period":"2024-09-30","estimate":1.6,"surprise":0.04,"surprisePercent":2.5}]},"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":{"p10Cents":"0.3000","medianCents":"0.3000","p90Cents":"0.3000","minCents":"0.3000","maxCents":"0.3000","p95Cents":"0.3000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_W7irF69rFB1YUXF9ue9ew","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 the last 4 quarters of earnings data for any US stock, including actual vs. estimated EPS, surprise, and surprise percent.","exampleAgentPrompt":"Can you pull up the last 4 quarters of earnings for NVDA — I want to see whether it beat or missed analyst EPS estimates each quarter and by how much?","exampleUseCases":[{"title":"Track earnings beat/miss streaks","prompt":"Show me the last 4 quarters of earnings for Apple — I need to see if they've been consistently beating or missing EPS estimates and what the surprise percentages look like."},{"title":"Compare competitor earnings surprises","prompt":"Can you pull the recent earnings history for both Microsoft and Google? I want to compare their EPS surprise percentages side by side to see which one has been beating estimates more consistently."},{"title":"Identify earnings volatility patterns","prompt":"Get me the last 4 quarters of earnings data for Tesla — I'm looking for patterns in how much their actual EPS has varied from what analysts estimated."}],"resultDescription":"A JSON object containing the stock symbol and an array of up to 4 quarterly earnings records, each with the reporting period date, actual EPS, estimated EPS, raw surprise value, and surprise percentage.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty earnings array","Stock not listed on NYSE, NASDAQ, or AMEX returns no data","Earnings data not yet available for the most recent quarter returns fewer than 4 records","Payment failure (insufficient USDC balance) blocks the request","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need structured, per-quarter EPS actuals vs. estimates with surprise metrics for any US-listed stock. Prefer this over a general stock quote endpoint when the specific question is about whether a company beat or missed earnings expectations historically. Best for NYSE, NASDAQ, and AMEX listed equities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:50:08.672Z","isFirstParty":false,"canonicalSlug":"tickersfeed-earnings-history-api-f61df09a"}