# TwelveX Earnings Calendar

> TwelveX Earnings Calendar is a paid API for AI agents from twelv1x402.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-14).

Returns a calendar of upcoming and historical corporate earnings announcements filtered by date range

## Facts

- Endpoint: GET https://twelv1x402.vercel.app/api/earnings-calendar
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twelvex-earnings-calendar-625ed22e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gf4UVYcIg2l1KsiRIbzS4

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 twelvex-earnings-calendar-625ed22e
```

Example prompt: Pull the earnings calendar from Twelve Data for next week — from Monday May 19 to Friday May 23 — so I can see which companies are reporting.

## When to prefer this

Use this endpoint when you need a date-bounded list of corporate earnings announcements including EPS estimates and actuals. Prefer this over manual web scraping or free tier APIs when you need reliable, structured earnings data with broad market coverage spanning stocks, forex context, and crypto-adjacent equities, and are willing to pay per-call pricing for accuracy.

## Known failure modes

- Invalid date format returns an error — dates must be in YYYY-MM-DD format
- Date range too broad may return empty or truncated results
- Missing start_date or end_date may return a validation error or default to a narrow window
- Upstream Twelve Data API outage results in a 502 or 503 response
- Payment of 0.15 USDC not received triggers a 402 Payment Required response

## How this service works

Premium financial data API — 25 endpoints for stocks, forex, crypto, and technical analysis. Powered by Twelve Data.

## Output

A structured list of earnings events within the specified date range, including company names, ticker symbols, scheduled earnings dates, expected EPS estimates, actual EPS values (for past events), revenue estimates, and fiscal quarter details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "end_date": {
   "type": "string"
  },
  "start_date": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twelvex-earnings-calendar-625ed22e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twelv1x402.vercel.app](https://www.zero.xyz/host/twelv1x402.vercel.app/llms.txt)