# Finnhub Earnings Calendar via gateway.apiosk.com

> Finnhub Earnings Calendar via gateway.apiosk.com is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.13/call, status unknown (last checked 2026-09-14).

Retrieves scheduled and reported corporate earnings data for a date range, optionally filtered by stock symbol and international markets

## Facts

- Endpoint: GET https://gateway.apiosk.com/finnhub/calendar/earnings
- Price: $0.13/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finnhub-earnings-calendar-via-gateway-apiosk-com-f7b03572
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YYle8n7JrYIwYyetkdrM1

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 finnhub-earnings-calendar-via-gateway-apiosk-com-f7b03572
```

Example prompt: What companies are reporting earnings between July 28 and August 1, 2026? Include any after-market or before-market reports and show me the EPS estimates — filter to US markets only.

## When to prefer this

Use this endpoint when you need structured earnings calendar data including EPS and revenue estimates and actuals for US (and optionally international) equities, especially when you need to filter by specific ticker or date range. Prefer this over manual scraping or general financial news APIs when you need machine-readable estimate vs. actual comparisons by quarter.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) results in an error or empty response
- Unknown or delisted symbol returns an empty earningsCalendar array
- Date range too broad may result in large payloads or timeouts
- Finnhub upstream outage causes gateway error
- Payment failure (insufficient USDC balance) blocks the request with a 402 response

## How this service works

Earnings calendar: historical and upcoming earnings releases. EPS and revenue figures are non-GAAP.

## Output

Returns an earningsCalendar array where each entry contains the earnings date, reporting hour (amc = after market close, bmo = before market open), fiscal year, quarter, stock symbol, actual and estimated EPS, and actual and estimated revenue. Null values appear for actual figures when earnings have not yet been reported.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finnhub-earnings-calendar-via-gateway-apiosk-com-f7b03572/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)