# market2000.xyz Earnings Surprise

> market2000.xyz Earnings Surprise is a paid API for AI agents from market2000.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns earnings beat/miss history, average surprise magnitude, per-quarter price reactions, and consistency signals for a given stock ticker over a configurable number of quarters.

## Facts

- Endpoint: GET https://market2000.xyz/api/earnings-surprise
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market2000-xyz-earnings-surprise-1fd15ffd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_45BY1MzR_K3uDE44_Y2VD

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 market2000-xyz-earnings-surprise-1fd15ffd
```

Example prompt: Pull the earnings surprise history for NVDA over the last 8 quarters — I want to see the beat rate, average surprise, and whether it's flagged as a consistent beater.

## When to prefer this

Use this endpoint when you need a quick, structured summary of a stock's earnings surprise track record — beat rate, magnitude, and price reaction — without building your own earnings database. It is especially useful pre-earnings as a signal-quality check, or when screening for consistent earnings beaters. Prefer this over general financial data APIs when you specifically need the consistency signals and aggregated surprise metrics rather than raw earnings figures.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Periods parameter outside 4–20 range may be rejected or clamped
- Insufficient historical data for lesser-known or newly listed stocks
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting or timeout on high-frequency calls

## How this service works

Earnings Surprise — beat/miss history, price reaction, consistency signals.

HOW TO CALL:
  GET /api/earnings-surprise?ticker=NVDA&periods=8

PARAMETERS:
  ticker  — stock ticker (required)
  periods — quarters to analyze, 4–20 (default 8)

RESPONSE: beat_rate, avg surprise, per-quarter reactions, signals{consistent_beater,…}.

PRICING: $0.02 per call.

## Output

Returns a structured response including: overall beat rate (fraction of quarters where actual earnings exceeded estimates), average earnings surprise percentage, a per-quarter breakdown of surprise magnitude and subsequent price reaction, and derived signals such as whether the ticker qualifies as a 'consistent_beater' or shows other behavioral patterns across the analyzed period.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "Stock ticker (NVDA, TSLA, LLY)"
      },
      "periods": {
       "type": "integer",
       "default": 8,
       "description": "Quarters to analyze (4–20)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market2000-xyz-earnings-surprise-1fd15ffd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market2000.xyz](https://www.zero.xyz/host/market2000.xyz/llms.txt)