# agent402.tools Earnings Calendar

> agent402.tools Earnings Calendar is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns a list of all companies reporting earnings on a given date, including EPS estimates, actuals, and reporting time slots, optionally filtered by ticker symbol.

## Facts

- Endpoint: GET https://agent402.tools/api/earnings-calendar
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-earnings-calendar-28b5c176
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bqKT-0M5SVF4jgaNgbedw

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 agent402-tools-earnings-calendar-28b5c176
```

Example prompt: Pull up the earnings calendar for January 22, 2025 — I want to see every company reporting that day with their EPS estimates and whether they've already reported actuals, and also filter it down to just AAPL if it's on the list.

## When to prefer this

Use this endpoint when you need a structured, filterable earnings calendar tied to a specific date, especially when you need EPS estimates and actuals together. Prefer this over general financial news APIs when you want machine-readable earnings data keyed by date or ticker, and when you want Nasdaq-sourced data without building your own scraper.

## Known failure modes

- Invalid date format returns an error — must be YYYY-MM-DD
- No earnings scheduled for a given date returns an empty list (e.g. weekends, holidays)
- Unknown or invalid ticker symbol filter may return empty results rather than an error
- Nasdaq source data may have delays or missing actuals for very recent reports
- Network timeout or upstream Nasdaq unavailability may cause transient failures

## How this service works

Earnings calendar for a given date - every company reporting that day with EPS estimate, EPS actual (if reported), and reporting time slot. Optional `symbol` filter narrows to one ticker. Defaults to today (UTC). Backed by Nasdaq's public calendar API.

## Output

A list of companies reporting earnings on the specified date, each with ticker symbol, company name, EPS estimate, EPS actual (if already reported), and the reporting time slot (e.g., before market open, after market close).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD (default: today UTC)"
      },
      "symbol": {
       "type": "string",
       "description": "Optional ticker filter"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "date",
      "count",
      "entries"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "entries": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string"
         },
         "time": {
          "type": "string"
         },
         "symbol": {
          "type": "string"
         },
         "epsActual": {},
         "marketCap": {
          "type": "integer"
         },
         "epsEstimate": {
          "type": "number"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-06-22",
  "count": 2,
  "entries": [
   {
    "name": "Apple Inc.",
    "time": "amc",
    "symbol": "AAPL",
    "epsActual": null,
    "marketCap": 3400000000000,
    "epsEstimate": 1.55
   },
   {
    "name": "Tesla, Inc.",
    "time": "bmo",
    "symbol": "TSLA",
    "epsActual": null,
    "marketCap": 800000000000,
    "epsEstimate": 0.72
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-earnings-calendar-28b5c176/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)