# finanz.halowerk.com Earnings Calendar

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

Builds a historical and projected earnings/filing calendar for a company from SEC filings, including period end dates, filing dates, form types, EPS, revenue, and an estimated next filing window derived from median historical lag.

## Facts

- Endpoint: POST https://finanz.halowerk.com/v1/earnings-calendar
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finanz-halowerk-com-earnings-calendar-8eda215c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GHOTdrnehceCVlzvbh9WO

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 finanz-halowerk-com-earnings-calendar-8eda215c -d '<json body>'
```

Example prompt: Pull the SEC filing calendar for Apple — I want the period end dates, actual filing dates, form types, reported EPS and revenue for each past period, and your estimate of when the next filing is expected based on their historical lag.

## When to prefer this

Use this endpoint when you need the actual as-filed SEC figures (EPS, revenue) per reporting period alongside filing metadata (dates, form types), and especially when you want a statistically derived estimate of the next filing window. Prefer this over analyst estimate services when ground-truth reported figures matter, or over generic calendar APIs when you need SEC-specific filing lag analysis.

## Known failure modes

- Unknown or invalid ticker/CIK returns an error or empty result
- Companies with irregular filing histories produce unreliable lag estimates
- Very recent filings may not yet be indexed on EDGAR
- Foreign private issuers using 20-F instead of 10-K may not be supported
- Estimated next filing window is explicitly marked as a projection and may be wrong if a company files unusually early or late

## How this service works

Builds a reporting calendar from SEC filings. For each past period it gives the period end, the date the report was filed, the form type, and the earnings per share and revenue as filed — the reported figures, not a summary of them. From the historical gap between period end and filing date it derives the median lag and projects the next expected filing window, clearly marked as an estimate: the SEC publishes no forward calendar, and a company can file early or late.

## Output

Returns a list of past reporting periods each containing the period end date, the date the report was filed with the SEC, the form type (e.g. 10-K, 10-Q), the as-filed earnings per share, and the as-filed revenue. Also returns the median historical lag between period end and filing date, and a clearly marked estimated window for the next expected filing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "forms": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Restrict to these form types, e.g. [\"10-Q\"]."
  },
  "limit": {
   "type": "integer",
   "default": 6,
   "maximum": 16,
   "minimum": 1,
   "description": "How many past reports."
  },
  "issuer": {
   "type": "string",
   "maxLength": 40,
   "description": "Ticker such as MSFT, or a CIK number."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finanz-halowerk-com-earnings-calendar-8eda215c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finanz.halowerk.com](https://www.zero.xyz/host/finanz.halowerk.com/llms.txt)