# Alpha Vantage Earnings

> Alpha Vantage Earnings is a paid API for AI agents from Alpha Vantage at alphavantage.mpp.paywithlocus.com, paid per call via MPP, $0.008/call, status unknown (last checked 2026-10-11).

Retrieves earnings data (EPS, revenue, and related financials) for a given stock ticker symbol

## Facts

- Endpoint: POST https://alphavantage.mpp.paywithlocus.com/alphavantage/earnings?utm_source=zero.xyz
- Price: $0.008/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Alpha Vantage
- Docs: https://www.alphavantage.co/documentation/
- Website: https://www.alphavantage.co
- Tags: finance, stocks, forex, crypto, market-data, technical-analysis, data
- Canonical page: https://www.zero.xyz/c/alpha-vantage-earnings-f33ab12c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d39ge84E1jzz7CEO1ULsY

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 alpha-vantage-earnings-f33ab12c -d '<json body>'
```

Example prompt: Pull up the earnings history for Apple (AAPL) — I want to see the quarterly and annual EPS figures, including estimated vs actual and any earnings surprises.

## When to prefer this

Use this endpoint when you need historical earnings data (EPS, revenue, surprise) for a publicly traded US stock. Prefer this over general time series endpoints when the user specifically asks about earnings, EPS, or fundamental financial performance rather than price history or technical indicators.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty result
- Rate limit exceeded returns an API limit error
- Network or provider timeout causes request failure
- Delisted or OTC stocks may return incomplete or no data

## How this service works

Annual and quarterly earnings history — reported EPS, estimated EPS, and surprise percentage.

## Output

Returns a structured dataset of annual and quarterly earnings for the requested stock ticker, including reported EPS, estimated EPS, surprise amount, surprise percentage, fiscal date ending, and reported dates. The response is typically large (20+ KB) and covers multiple years of historical earnings data.

## Example request

```json
{
 "symbol": "MSFT"
}
```

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-earnings-f33ab12c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alphavantage.mpp.paywithlocus.com](https://www.zero.xyz/host/alphavantage.mpp.paywithlocus.com/llms.txt)