# Financial Data x402 – Earnings Calendar & Surprises

> Financial Data x402 – Earnings Calendar & Surprises is a paid API for AI agents from x402-stock-indicators.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns earnings calendar dates, EPS/revenue estimates, historical earnings surprises, and estimate revision trends for a given stock ticker.

## Facts

- Endpoint: GET https://x402-stock-indicators.vercel.app/earnings/%7Bticker%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-data-x402-earnings-calendar-surprises-eb0f1bbc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LkD4bsTZdPoY87lzmXAt1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability financial-data-x402-earnings-calendar-surprises-eb0f1bbc
```

Example prompt: What are the upcoming earnings dates and current EPS estimates for AAPL, and did they beat or miss last quarter?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-data-x402-earnings-calendar-surprises-eb0f1bbc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-stock-indicators.vercel.app](https://www.zero.xyz/host/x402-stock-indicators.vercel.app/llms.txt)