# TwelveX Earnings Data by Symbol

> TwelveX Earnings Data by Symbol is a paid API for AI agents from twelvix402.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

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

## Facts

- Endpoint: POST https://twelvix402.vercel.app/api/earnings/%7Bsymbol%7D
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twelvex-earnings-data-by-symbol-cdb177d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l2QEXdbjGLillfW70RyIN

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-by-symbol-cdb177d0 -d '<json body>'
```

Example prompt: Pull the latest earnings data for AAPL — I want to see the actual vs estimated EPS and any earnings surprise from the most recent quarters.

## When to prefer this

Use this endpoint when you need structured earnings data (EPS, revenue, surprise) for a specific stock ticker and want a pay-per-call micropayment model via x402 rather than a subscription. Best for agents that need on-demand fundamental data without a long-term API subscription commitment.

## Known failure modes

- Invalid or unsupported ticker symbol returns an error
- Symbol not found in Twelve Data database
- Payment failure (402) if USDC micropayment not processed
- Rate limiting or quota exceeded
- Network timeout on Vercel deployment
- Missing or malformed symbol parameter in URL

## 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 EPS (actual and estimated), earnings dates, revenue figures, and earnings surprise metrics sourced from Twelve Data.

## More

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