# 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"
```

**Response:**
```json
{
    "data": {
        "date": "2026-06-12",
        "count": 17,
        "market": "US",
        "source": "Nasdaq",
        "calendar": "earnings",
        "earnings": [
            {
                "name": "Sibanye Stillwater Limited",
                "symbol": "SBSW",
                "eps_forecast": null,
                "last_year_eps": null,
                "num_estimates": null,
                "market_cap_usd": 6425387689,
                "reporting_time": "unspecified",
                "fiscal_quarter_ending": "Mar/2026",
                "last_year_report_date": null
            },
            {
                "name": "High Templar Tech Limited",
                "symbol": "HTT",
                "eps_forecast": null,
                "last_year_eps": 0.12,
                "num_estimates": null,
                "market_cap_usd": 461192007,
                "reporting_time": "unspecified",
                "fiscal_quarter_ending": "Mar/2026",
                "last_year_report_date": null
            },
            {
                "name": "GDEV Inc.",
                "symbol": "GDEV",
                "eps_forecast": 0.67,
                "last_year_eps": 0.77,
                "num_estimates": 1,
                "market_cap_usd": 242544985,
                "reporting_time": "unspecified",
                "fiscal_quarter_ending": "Mar/2026",
                "last_year_report_date": "5/16/2025"
            },
            {
                "name": "Waldencast plc",
       
…(truncated, see openapi.json for full schema)
```

### Splits

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

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

**Response:**
```json
{
    "data": {
        "count": 16,
        "market": "US",
        "source": "Nasdaq",
        "splits": [
            {
                "name": "CrowdStrike Holdings, Inc.",
                "ratio": "4:1",
                "symbol": "CRWD",
                "record_date": null,
                "payable_date": null,
                "announced_date": null,
                "execution_date": "7/02/2026"
            },
            {
                "name": "Sumitomo Electric Industries Ltd. ADR",
                "ratio": "8 : 1",
                "symbol": "SMTOY",
                "record_date": null,
                "payable_date": null,
                "announced_date": null,
                "execution_date": "7/02/2026"
            },
            {
                "name": "Kao Corporation ADR",
                "ratio": "6 : 5",
                "symbol": "KAOOY",
                "record_date": null,
                "payable_date": null,
                "announced_date": null,
                "execution_date": "7/01/2026"
            },
            {
                "name": "Mueller Industries, Inc.",
                "ratio": "2 : 1",
                "symbol": "MLI",
                "record_date": null,
                "payable_date": null,
                "announced_date": null,
                "execution_date": "7/01/2026"
            },
            {
                "name": "Honeywell International Inc.",
                "ratio": "1:2",
                "symbol": "HON",
       
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "The earnings endpoint takes date=YYYY-MM-DD (defaults to today, US Eastern). Reporting time is pre-market, after-hours or unspecified. EPS and market cap are numbers; missing values are null. Earnings rows are ranked by market cap.",
        "source": "Nasdaq public calendar feed (api.nasdaq.com/api/calendar, live)",
        "service": "earnings-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/splits": "Upcoming stock splits with ratio and execution date.",
            "GET /v1/earnings": "Companies reporting earnings on a date (date=2026-06-12, default today)."
        },
        "description": "Live US corporate-events calendar from Nasdaq — the earnings and stock-splits calendar. earnings = every company reporting on a date (ticker, name, consensus EPS forecast, reporting time before/after market, market cap, number of analyst estimates, fiscal quarter ending, prior-year EPS and report date); splits = upcoming stock splits (ticker, name, ratio, execution date). Live, no key, nothing stored. Distinct from the economic-calendar, IPO-calendar and dividend APIs.",
        "upstream_status": "ok",
        "todays_earnings_count": 36
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:34.706Z",
        "request_id": "5965295c-166b-4048-a919-f3ce6f191475"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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