# TwelveX Earnings Data API

> TwelveX Earnings Data API is a paid API for AI agents from tw3lvtrexdata.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-12).

Retrieves earnings data (EPS, revenue, estimates, surprises) for a given stock symbol via the Twelve Data backend.

## Facts

- Endpoint: POST https://tw3lvtrexdata.vercel.app/api/earnings/%7Bsymbol%7D?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twelvex-earnings-data-api-b657d3ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DZUR2h2KtwoDs4N0s4cKC

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-data-api-b657d3ea -d '<json body>'
```

Example prompt: Can you pull the latest earnings data for AAPL — I want to see the actual vs estimated EPS and whether they beat or missed?

## When to prefer this

Use this endpoint when you need structured earnings data (EPS actuals, estimates, surprises) for a publicly traded stock and want a pay-per-call model via x402/USDC rather than a subscription. Prefer this over general financial data APIs when cost control per query matters or when integrating with crypto-native agent workflows.

## Known failure modes

- Invalid or unrecognized stock symbol returns an error
- Symbol for a non-public or delisted company may return empty data
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Twelve Data upstream outage may cause delayed or failed responses
- Futures or ETF symbols may not have earnings data

## How this service works

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

## Output

Returns earnings data for the specified stock symbol including actual EPS, estimated EPS, earnings surprise (beat/miss), revenue figures, and reporting period dates sourced from Twelve Data.

## More

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