# The Stall — Earnings Surprises

> The Stall — Earnings Surprises is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns historical earnings surprise data (EPS estimates vs actuals) for a given US stock ticker over up to 8 past quarters

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/earnings-surprises
- 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/the-stall-earnings-surprises-f88f6731
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o5D148asB3Cyi7XlmJj7U

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 the-stall-earnings-surprises-f88f6731
```

Example prompt: Pull the earnings surprise history for NVDA — how much did they beat or miss EPS estimates over the last 8 quarters?

## When to prefer this

Use this endpoint when you need historical earnings surprise data (EPS estimate vs actual) for a specific US-listed stock. Ideal for fundamental analysis workflows, screening stocks with consistent earnings beats, or building earnings momentum signals. Prefer this over general financial data endpoints when you specifically need structured surprise deltas per quarter, not just raw EPS figures.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- quarters parameter out of range (less than 1 or more than 8) may return a validation error
- Payment not processed (402 response if USDC payment on Base mainnet fails)
- Ticker with no earnings history (e.g. newly listed company) may return empty data
- Non-US tickers may not be supported

## How this service works

Historical EPS beat/miss data for any US equity: actual EPS, consensus estimate, surprise %, beat rate, estimate revisions (30-day EPS drift), and next earnings date. Free Yahoo Finance data, no API key. Pairs with analyst-ratings and equity-fundamentals for a complete earnings intelligence stack.

## Output

Returns a list of quarterly earnings records for the requested ticker, each containing the fiscal quarter, analyst consensus EPS estimate, actual reported EPS, and the surprise amount or percentage. Covers up to 8 trailing quarters depending on the requested range.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ticker": "AAPL",
   "quarters": 4
  }
 }
}
```

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/the-stall-earnings-surprises-f88f6731/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)