{"uid":"cap_NeWrypvALs62KW7HoG-_m","slug":"financial-datasets-earnings-snapshots-api-abc03d4b","name":"Financial Datasets Earnings Snapshots API","description":"Earnings snapshots for a US-listed ticker from the earnings release: quarterly and year-to-date revenue, EPS, net income, estimates, surprises and year-over-year changes where available, with the filing date and source URL; newest first. Use when an agent asks how the latest quarter compared with estimates or a year ago. Non-Professional use; Professional use needs a plan at financialdatasets.ai.","url":"https://api.financialdatasets.ai/earnings?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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":1,"description":"Number of most-recent report periods worth of filings to return, sorted by (report_period DESC, filing_date ASC)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous response's next_page_url."},"ticker":{"type":"string","description":"The ticker symbol (e.g. AAPL)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__g48h2XFYnxJ6pK8FOLQS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns earnings release data for a US-listed ticker including quarterly/YTD revenue, EPS, net income, analyst estimates, surprises, and year-over-year changes, newest first.","exampleAgentPrompt":"What were NVIDIA's most recent quarterly earnings — did they beat analyst estimates, and how did EPS and revenue compare to the same quarter a year ago?","exampleUseCases":[{"title":"Earnings beat or miss check","prompt":"Did Apple beat or miss analyst estimates last quarter, and what was the earnings surprise amount for both EPS and revenue?"},{"title":"Year-over-year earnings growth","prompt":"How did Amazon's net income and revenue change compared to the same quarter a year ago? Pull the two most recent quarters so I can see the trend."},{"title":"Pre-earnings briefing for investor","prompt":"I'm about to listen to the Microsoft earnings call — can you pull the latest quarter's results including EPS, revenue, and whether they beat expectations?"}],"resultDescription":"A list of earnings snapshot objects sorted newest first, each containing the report period, filing date, quarterly and year-to-date revenue, EPS (actual and estimated), net income, earnings surprise (absolute and percentage), year-over-year change figures where available, and a source URL to the original filing or earnings release.","failureModes":["Invalid or unrecognized ticker symbol returns an empty result or 404-style error","Non-Professional use limitations may restrict access to historical depth or certain fields without a paid plan","Pagination cursor mismatch or stale cursor may return an error or unexpected page","Rate limiting or payment failure (x402) may block the call","Tickers for non-US-listed companies will not return results"],"whenToPreferThis":"Use this endpoint when you need structured earnings release data — EPS, revenue, estimates, and surprises — for a US-listed stock, especially when comparing the latest quarter against analyst expectations or the prior year. Prefer this over income statement endpoints when you specifically need the earnings-release view with analyst estimate and surprise fields, rather than raw standardized SEC filing financials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:59:46.646Z","isFirstParty":false,"canonicalSlug":"financial-datasets-earnings-snapshots-api-abc03d4b"}