# Earnings Calendar & Revisions

> Earnings Calendar & Revisions 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 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://x402-stock-indicators.vercel.app/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-a7e6bd72
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E-M5ks3sS-7vbfsjmbyTd

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-a7e6bd72
```

Example prompt: Pull up the full earnings picture for NVDA — next earnings date, EPS and revenue estimates, how it's surprised over the last four quarters, and whether analyst estimates have been revised up or down recently.

## When to prefer this

Choose this endpoint when you need a comprehensive earnings intelligence package in a single call — combining the earnings calendar date, analyst estimates, historical surprise data, and estimate revision trends. Prefer this over plain earnings calendar APIs when you need to gauge whether sentiment is improving or deteriorating before an earnings event, or when you want to contextualize upcoming earnings with historical beat/miss patterns.

## Known failure modes

- Invalid or unknown ticker symbol returns 404 or error response
- Non-US or delisted tickers may return no data
- Earnings date unavailable for companies that haven't scheduled yet
- Yahoo Finance data outage may cause stale or missing fields
- Payment failure (insufficient USDC balance) prevents call from completing

## 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.01/call.

## Output

Returns a structured JSON object containing: next scheduled earnings date, consensus EPS and revenue estimates, actual vs. estimated results for the last 4 quarters (including surprise magnitude), and estimate revision sentiment over 7, 30, 60, and 90-day windows — a leading indicator of Wall Street sentiment.

## 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-a7e6bd72/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)