# Earnings & Stock Splits Calendar API
> Live US corporate-events calendar from Nasdaq — no key, nothing stored. The earnings and stock-splits calendar: which companies report earnings on a given day and which stocks are about to split, distinct from the economic-calendar, IPO-calendar and dividend APIs in the catalogue. The earnings endpoint returns every company reporting on a date — ticker, name, the consensus EPS forecast, the reporting time (before market open or after market close), market cap, the number of analyst estimates, the fiscal quarter ending and the prior-year EPS and report date — ranked by market cap. The splits endpoint returns the upcoming stock splits: ticker, name, the split ratio and the execution date. Build earnings-season dashboards, event-driven trading bots, investor-relations trackers and "who reports today" widgets on top of real Nasdaq calendar data. The earnings endpoint defaults to today (US Eastern) and accepts any date; EPS and market cap come back as clean numbers and reporting time is normalised to pre-market, after-hours or unspecified.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/earnings-api/..."
```

## Pricing
- **Free** (Free) — 13,000 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 205,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 840,000 calls/Mo, 28 req/s
- **Scale** ($55/Mo) — 3,050,000 calls/Mo, 60 req/s

## Endpoints

### Earnings

#### `GET /v1/earnings` — Companies reporting earnings on a date

**Parameters:**
- `date` (query, optional, string) — Date YYYY-MM-DD (default today, US Eastern) Example: `2026-06-12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/earnings-api/v1/earnings?date=2026-06-12"
```

### Splits

#### `GET /v1/splits` — Upcoming stock splits

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/earnings-api/v1/splits"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/earnings-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/earnings-api
OpenAPI spec: https://www.oanor.com/api/earnings-api/openapi.json