# Earnings Calendar & Revisions

> Earnings Calendar & Revisions is a paid API for AI agents from www.x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns next earnings date with EPS/revenue estimates, last 4 quarters of actual-vs-estimate surprises, and estimate revision trends over 7/30/60/90 days for a US stock ticker.

## Facts

- Endpoint: GET https://www.x402financialdata.com/earnings/:ticker
- 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/earnings-calendar-revisions-91cf468b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NdzbZe7nix592-GLHlin9

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 earnings-calendar-revisions-91cf468b
```

Example prompt: What are the earnings estimates and revision trends for NVDA — I want to see the next earnings date, EPS and revenue consensus, whether analysts have been revising up or down over the last 30 days, and the last 4 quarters of actual-vs-estimate surprises.

## When to prefer this

Choose this endpoint when you need a comprehensive earnings intelligence snapshot for a single US stock in one call — especially when estimate revision trends (7/30/60/90-day) are important, as most earnings-calendar APIs omit this leading sentiment signal. Prefer this over generic earnings calendar APIs when you need both historical surprise data and forward estimate context together.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Ticker exists but has no upcoming earnings date scheduled (e.g. ETFs, non-reporting entities)
- Data temporarily unavailable from Yahoo Finance upstream source
- Payment not processed — x402 payment required before data is returned
- Rate limiting or timeout if called at high frequency

## How this service works

Earnings intelligence for a US stock in one call, not just a calendar: next earnings date with EPS/revenue estimates, the last 4 quarters' actual-vs-estimate surprises, and whether Wall Street's estimates are being revised up or down over 7/30/60/90 days -- a leading sentiment signal most earnings-calendar APIs don't offer. From real Yahoo Finance data. $0.005/call.

## Output

Returns a structured payload containing: the next scheduled earnings date, consensus EPS and revenue estimates for the upcoming quarter, actual vs. estimated results for the prior 4 quarters (including surprise magnitude), and estimate revision direction indicators over 7, 30, 60, and 90-day windows — all sourced from real Yahoo Finance data.

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL, TSLA, MSFT"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/earnings-calendar-revisions-91cf468b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402financialdata.com](https://www.zero.xyz/host/www.x402financialdata.com/llms.txt)