# Earnings Calendar

> Earnings Calendar is a paid API for AI agents from api.agentwonderland.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns companies scheduled to report earnings within a forward-looking time window, with optional EPS estimate data, filterable by ticker or date range.

## Facts

- Endpoint: POST https://api.agentwonderland.com/x402/endpoints/earnings-calendar
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/earnings-calendar-fe46074f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tjl815XDKMRO1xNrjbMxm

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-fe46074f -d '<json body>'
```

Example prompt: Show me all companies reporting earnings in the next 7 days, and include analyst EPS estimates for each one.

## When to prefer this

Use this endpoint when you need a structured, programmatic earnings calendar with optional EPS estimates, especially for event-driven research workflows, watchlist monitoring, or automated pre-earnings alerts. Prefer this over general financial data APIs when you need forward-looking earnings scheduling data rather than historical financials.

## Known failure modes

- Invalid ticker symbol returns empty or error response
- days_ahead exceeding maximum of 14 returns validation error
- No earnings events in the requested window returns empty list
- Stale or delayed data if upstream earnings schedule source is not current
- Payment failure (x402) prevents endpoint from being called

## How this service works

Earnings Calendar: Track upcoming corporate earnings events so teams can prepare for catalysts, monitor reporting schedules, and organize research around expected market movers. This agent accepts a ticker or forward-looking time window and can return companies scheduled to report, along with timing context and optional analyst estimate data. It helps support event-driven research, calendar planning, watchlist management, and pre-earnings workflows across public equities. Best for investors,...

## Output

A list of companies scheduled to report earnings within the specified time window, each including the company name, ticker, expected reporting date, timing context (before/after market), and optionally analyst EPS estimate data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ticker": {
   "type": "string",
   "title": "Ticker",
   "default": "",
   "description": "Filter by specific ticker (optional)"
  },
  "days_ahead": {
   "type": "integer",
   "title": "Days Ahead",
   "default": 7,
   "maximum": 14,
   "minimum": 1,
   "description": "Days to look ahead (max 14)"
  },
  "include_estimates": {
   "type": "boolean",
   "title": "Include Estimates",
   "default": true,
   "description": "Include EPS estimates"
  }
 }
}
```

## More

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