# TickersFeed Earnings Calendar

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

Returns upcoming US company earnings report dates with estimated EPS and revenue for a specified date range or ticker symbol

## Facts

- Endpoint: GET https://api.tickersfeed.net/calendar/earnings
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tickersfeed-earnings-calendar-bb802906
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d7bz4PKrppD4HTI4Rh_C8

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 tickersfeed-earnings-calendar-bb802906
```

Example prompt: Pull the earnings calendar for the next two weeks and show me which companies are reporting, along with their estimated EPS and revenue — I want to plan around earnings season.

## When to prefer this

Use this endpoint when you need a forward-looking earnings calendar for US equities — specifically to find which companies report on which dates and what analysts expect for EPS and revenue. Prefer this over general stock quote or fundamentals endpoints when the goal is event-driven planning, earnings season tracking, or scheduling alerts around report dates. It is especially useful for portfolio-level earnings monitoring when combined with a ?symbol= filter.

## Known failure modes

- Date window exceeds 30 days — likely returns an error or truncated results
- Invalid date format (not YYYY-MM-DD) — API may return a 400 bad request
- Unknown or OTC ticker symbol passed via ?symbol= — may return empty array
- Payment not included or insufficient USDC — x402 payment required error
- No earnings scheduled in the requested window — returns an empty array

## How this service works

Upcoming US company earnings calendar — which companies report in a date window, with estimated EPS and revenue, as JSON. Default is the next 7 days; filter with ?from=YYYY-MM-DD&to=YYYY-MM-DD (window up to 30 days) or ?symbol=AAPL. Use for: earnings season monitoring, upcoming earnings this week, portfolio earnings alerts, event-driven trading calendar, pre-earnings positioning. $0.005 USDC per call.

## Output

A JSON array of upcoming earnings events, each containing the company name, ticker symbol, scheduled report date, estimated EPS, and estimated revenue, covering the requested date window (default next 7 days, max 30 days).

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "End date YYYY-MM-DD (default +7 days, window ≤30d)"
      },
      "from": {
       "type": "string",
       "description": "Start date YYYY-MM-DD (default today)"
      },
      "symbol": {
       "type": "string",
       "description": "Optional ticker filter (e.g. AAPL)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tickersfeed-earnings-calendar-bb802906/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)