# Financial Data x402 – Earnings Endpoint

> Financial Data x402 – Earnings Endpoint is a paid API for AI agents from x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: GET https://x402financialdata.com/earnings/%7Bticker%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-data-x402-earnings-endpoint-36ace305
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ak0OCwpdBsAhPef2iEzxx

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-endpoint-36ace305
```

Example prompt: What are the upcoming earnings dates and current EPS estimates for AAPL, and has it been beating or missing estimates recently?

## When to prefer this

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.

## Known failure modes

- 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

## 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, 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.

## 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-endpoint-36ace305/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402financialdata.com](https://www.zero.xyz/host/x402financialdata.com/llms.txt)