# TickersFeed Stock Earnings

> TickersFeed Stock Earnings is a paid API for AI agents from api.tickersfeed.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14, last successful call 2026-06-15).

Returns historical and recent earnings data for a given stock ticker, including actual EPS, estimate, surprise, and surprise percent by period.

## Facts

- Endpoint: GET https://api.tickersfeed.net/stock/AAPL/earnings
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-06-15
- Success rate: 100% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-tickersfeed-net-90ae3ae4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hJ67S5iMmEflTHhmFv2Nt

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 api-tickersfeed-net-90ae3ae4
```

Example prompt: Pull up the earnings history for AAPL — I want to see the actual EPS, analyst estimates, and how much they beat or missed each quarter.

## When to prefer this

Use this endpoint when you need structured historical earnings data — EPS actuals, estimates, and surprise metrics — for US-listed equities on NYSE, NASDAQ, or AMEX. Prefer this over news endpoints when the agent needs quantitative earnings figures rather than headlines, or over price quote endpoints when the user is specifically asking about earnings performance rather than current price.

## Known failure modes

- Unknown or invalid ticker symbol returns empty earnings array or 404
- Symbol not covered by NYSE/NASDAQ/AMEX exchange scope
- Network or payment authorization failure via x402 protocol
- Missing required symbol parameter returns validation error
- Rate limiting or quota exceeded returns 429

## How this service works

Returns earnings data and surprises for a requested stock ticker.

## Output

Returns an array of earnings records for the requested ticker symbol, each containing the reporting period date, actual EPS, estimated EPS, surprise value, and surprise percent. For example, AAPL Q4 2024 shows actual 1.64, estimate 1.60, surprise +0.04 (+2.5%).

## Example request

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

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "symbol": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Stock ticker symbol (e.g. AAPL, MSFT)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-tickersfeed-net-90ae3ae4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tickersfeed.net](https://www.zero.xyz/host/api.tickersfeed.net/llms.txt)