{"uid":"cap_LkD4bsTZdPoY87lzmXAt1","slug":"financial-data-x402-earnings-calendar-surprises-eb0f1bbc","name":"Financial Data x402 – Earnings Calendar & Surprises","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://x402-stock-indicators.vercel.app/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_8v-iEXDTF2zV5fzYKeAiT","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, historical earnings surprises, and estimate revision trends for a given stock ticker.","exampleAgentPrompt":"What are the upcoming earnings dates and current EPS estimates for AAPL, and did they beat or miss last quarter?","exampleUseCases":[{"title":"Earnings date alert for portfolio","prompt":"When is NVDA's next earnings report and what's the current analyst EPS estimate going into it?"},{"title":"Post-earnings surprise analysis","prompt":"How much did Apple beat or miss EPS estimates in each of the last two quarters, and what's the surprise percentage?"},{"title":"Estimate revision monitoring for trade thesis","prompt":"Has the EPS estimate for AMD been revised up or down over the last 30 days heading into their next earnings?"}],"resultDescription":"A JSON object containing: the as-of date, ticker symbol, upcoming earnings dates, consensus EPS estimate (low/high/average), revenue estimate (low/high/average), recent historical earnings surprise records with actual vs. estimated EPS and surprise percentage, and estimate revision data showing how the consensus has shifted over the past 7, 30, 60, and 90 days.","failureModes":["Invalid or unsupported ticker symbol returns an error or empty data","Payment failure (insufficient USDC balance or unsupported chain) results in HTTP 402","Ticker exists but has no upcoming earnings scheduled returns an empty earnings_dates array","Estimate revision data may be sparse for small-cap or thinly-covered stocks","Stale data if upstream provider (Yahoo Finance) feed is delayed"],"whenToPreferThis":"Choose this endpoint when you need structured earnings calendar, EPS/revenue consensus estimates, earnings surprise history, or estimate revision trends for a specific US-listed stock — especially in a no-subscription, pay-per-call context using USDC on Base or Solana via the x402 protocol. Prefer it over screen-scraping or subscription data services when cost-per-call economics matter and API key management is undesirable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:42.292Z","isFirstParty":false}