{"uid":"cap_hJ67S5iMmEflTHhmFv2Nt","slug":"api-tickersfeed-net-90ae3ae4","name":"TickersFeed Stock Earnings","description":"Returns earnings data and surprises for a requested stock ticker.","url":"https://api.tickersfeed.net/stock/AAPL/earnings","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","properties":{"symbol":{"type":"string"}}},"queryParams":{"type":"object","properties":{"symbol":{"type":"string","description":"Stock ticker symbol (e.g. AAPL, MSFT)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"symbol":"MSFT"},"response":{"tier":"delayed","symbol":"AAPL","payment":{"payer":"0x9CC42f3d9245B867ACccd630B43f906c1665b176","isValid":true},"earnings":[{"year":2026,"actual":2.01,"period":"2026-03-31","symbol":"AAPL","quarter":2,"estimate":1.9884,"surprise":0.0216,"surprisePercent":1.0863},{"year":2026,"actual":2.84,"period":"2025-12-31","symbol":"AAPL","quarter":1,"estimate":2.7257,"surprise":0.1143,"surprisePercent":4.1934},{"year":2025,"actual":1.85,"period":"2025-09-30","symbol":"AAPL","quarter":4,"estimate":1.8075,"surprise":0.0425,"surprisePercent":2.3513},{"year":2025,"actual":1.57,"period":"2025-06-30","symbol":"AAPL","quarter":3,"estimate":1.4626,"surprise":0.1074,"surprisePercent":7.3431}],"price_usdc":0.003}},"exampleRequest":{"symbol":"MSFT"},"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"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_I26VmF25SngWtGm7rDdv1","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 historical and recent earnings data for a given stock ticker, including actual EPS, estimate, surprise, and surprise percent by period.","exampleAgentPrompt":"Pull up the earnings history for AAPL — I want to see the actual EPS, analyst estimates, and how much they beat or missed each quarter.","exampleUseCases":null,"resultDescription":"Returns an array of earnings records for the requested ticker symbol, each containing the reporting period date, actual EPS, estimated EPS, surprise value, and surprise percent. For example, AAPL Q4 2024 shows actual 1.64, estimate 1.60, surprise +0.04 (+2.5%).","failureModes":["Unknown or invalid ticker symbol returns empty earnings array or 404","Symbol not covered by NYSE/NASDAQ/AMEX exchange scope","Network or payment authorization failure via x402 protocol","Missing required symbol parameter returns validation error","Rate limiting or quota exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need structured historical earnings data — EPS actuals, estimates, and surprise metrics — for US-listed equities on NYSE, NASDAQ, or AMEX. Prefer this over news endpoints when the agent needs quantitative earnings figures rather than headlines, or over price quote endpoints when the user is specifically asking about earnings performance rather than current price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-06-16T15:11:59.702Z","lastSuccessfullyRanAt":"2026-06-15T22:41:06.512Z","lastHealthCheckAt":"2026-09-14T18:12:20.472Z","isFirstParty":false}