# Market2000 Earnings Surprise Pattern Analyzer

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

Analyzes historical earnings surprise patterns for a stock ticker, returning beat/miss history, EPS estimates vs actuals, and post-earnings price reaction signals.

## Facts

- Endpoint: GET https://market2000.xyz/earnings_surprise
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market2000-earnings-surprise-pattern-analyzer-4ee15108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o_-cUlO_VeWT4PR87ZrLQ

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-earnings-surprise-pattern-analyzer-4ee15108
```

Example prompt: Can you pull the earnings surprise history for AAPL over the last 8 quarters — I want to know if it consistently beats estimates, the average EPS surprise percentage, and how the stock price typically reacts after beats and misses?

## When to prefer this

Use this endpoint when you need a quantitative, pattern-based summary of a stock's historical earnings surprise behavior — especially when you want signals like consistent-beater status or post-earnings drift tendencies. Prefer this over raw earnings data sources when you need pre-computed signals ready for trading or screening decisions. Best for stocks with enough quarterly history (4+ periods) to generate meaningful patterns.

## Known failure modes

- Unknown or invalid ticker symbol returns an error or empty history
- Insufficient historical data for requested periods returns fewer records than requested
- Payment failure via x402 on Base results in 402 response with no data
- Rate limiting or overload may return 429 or 503 errors
- Delisted or OTC stocks may have incomplete EPS data

## How this service works

An origin the crawlers already index. We count what AI agents try to buy, what they are refused, and what the AI companies take without sending anyone back. Sold per call in USDC.

## Output

Returns a JSON object with: the ticker symbol, a list of historical quarterly earnings records (date, beat/miss result, EPS estimate, EPS reported, price reaction %), a summary (beat rate %, avg EPS surprise %, avg price reaction on beat and miss), total periods analyzed, and trading signals (consistent_beater, buy_dip_after_miss, high_volatility_event booleans).

## 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": {
      "last_n": {
       "type": "integer"
      },
      "ticker": {
       "type": "string"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "signal": {
       "type": "object"
      },
      "history": {
       "type": "array"
      },
      "summary": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "signal": {
   "consistent_beater": true,
   "buy_dip_after_miss": false,
   "high_volatility_event": false
  },
  "ticker": "AAPL",
  "history": [
   {
    "date": "2025-10-30",
    "beat_miss": "beat",
    "eps_estimate": 1.54,
    "eps_reported": 1.64,
    "price_reaction_pct": 1.8
   }
  ],
  "summary": {
   "beat_rate_pct": 87.5,
   "avg_eps_surprise_pct": 4.2,
   "avg_beat_reaction_pct": 2.1,
   "avg_miss_reaction_pct": -3.8
  },
  "periods_analyzed": 8
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market2000-earnings-surprise-pattern-analyzer-4ee15108/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)