{"uid":"cap_Ak0OCwpdBsAhPef2iEzxx","slug":"financial-data-x402-earnings-endpoint-36ace305","name":"Financial Data x402 – Earnings Endpoint","description":"Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.","url":"https://x402financialdata.com/earnings/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of":"2026-07-21","ticker":"AAPL","earnings_calendar":{"eps_estimate":{"low":1.83,"high":1.99,"average":1.894},"earnings_dates":["2026-07-30"],"revenue_estimate":{"low":107501000000,"high":112168000000,"average":108881511420}},"earnings_surprises":[{"quarter":"2026-03-31","eps_actual":2.01,"eps_estimate":1.9427,"eps_surprise_pct":3.46},{"quarter":"2025-12-31","eps_actual":2.84,"eps_estimate":2.6708,"eps_surprise_pct":6.34}],"estimate_revisions":{"0q":{"current":1.894,"trend_7d":"down","trend_30d":"down","7_days_ago":1.8943,"30_days_ago":1.8943,"60_days_ago":1.8943,"90_days_ago":1.7352}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y3wle-RXy4vVACEac5jkG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns earnings calendar dates, EPS/revenue estimates, earnings surprise history, and estimate revisions for a given stock ticker, paid per-call via USDC over x402.","exampleAgentPrompt":"What are the upcoming earnings dates and current EPS estimates for AAPL, and has it been beating or missing estimates recently?","exampleUseCases":[{"title":"Pre-earnings research for a trade","prompt":"I'm thinking about buying NVDA before earnings — can you pull the next earnings date, the consensus EPS and revenue estimates, and whether they've been beating or missing over the last few quarters?"},{"title":"Estimate revision trend monitoring","prompt":"Has the analyst EPS estimate for MSFT been moving up or down over the last 30 days? I want to know if Wall Street is getting more or less bullish before they report."},{"title":"Earnings surprise history review","prompt":"Pull the last few quarters of earnings surprises for TSLA — I want to see the actual vs estimated EPS and how big the beat or miss was each time."}],"resultDescription":"A JSON object containing: the as-of date, the ticker, the upcoming earnings dates, consensus EPS estimate (low/high/average), revenue estimate (low/high/average), historical earnings surprises per quarter (actual vs estimated EPS and surprise %), and estimate revision trends over 7, 30, 60, and 90 days with directional trend labels.","failureModes":["Invalid or unrecognized ticker returns an error or empty response","Payment not completed via x402 results in a 402 Payment Required response","Ticker for a non-public or delisted company may return no data","Estimate data may be unavailable for small-cap or thinly-covered stocks","Stale as-of date if upstream data provider has not yet refreshed"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable earnings data — including upcoming dates, analyst consensus estimates, surprise history, and revision trends — on a pay-per-call basis with no API key or subscription. It is ideal for agents that need on-demand financial research without managing credentials, especially when USDC micropayments via x402 are already part of the agent's payment stack.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:57:44.124Z","isFirstParty":false}