# AlphaLens Earnings Data API

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

Retrieves AI-powered earnings data and analysis for a given stock ticker symbol

## Facts

- Endpoint: POST https://alphacook.vercel.app/api/earnings
- 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/alphalens-earnings-data-api-274a820b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WR_Ke4j2Gxg4xrGMthZpO

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 alphalens-earnings-data-api-274a820b -d '<json body>'
```

Example prompt: Pull up the latest earnings data for NVDA — I want to see how they did versus estimates and whether they beat or missed EPS expectations.

## When to prefer this

Use this endpoint when you need structured earnings data — EPS, revenue, beat/miss signals — for a specific publicly traded stock. Prefer this over general market data endpoints when the user's question is specifically about quarterly earnings performance, earnings surprises, or fundamental earnings metrics.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty data
- Missing required 'symbol' field returns a 400-level validation error
- Downstream data provider outage causes failure or incomplete data
- Non-US or delisted tickers may return no results
- Rate limiting or payment failure via x402 protocol blocks the request

## How this service works

AI-powered stock analysis, technical indicators, sentiment scoring, and portfolio risk. 11 endpoints. Pay per request via x402 on Base chain.

## Output

Returns a success flag and a data object containing earnings-related information for the requested ticker, which may include EPS actuals vs estimates, revenue figures, earnings surprises, and historical quarterly earnings data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol"
 ],
 "properties": {
  "symbol": {
   "type": "string",
   "description": "symbol"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

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