# Market Calendar API > Live corporate-events calendar for US-listed stocks — the dates that move markets — served straight from Nasdaq's public calendar feed. For any trading day it answers the three questions a trader's calendar needs. The earnings endpoint lists every company reporting on a date with the session (pre-market or after-hours), the consensus EPS forecast, the number of analyst estimates, market cap and the year-ago actual EPS — so you can see, for example, Oracle reporting after the close with a $1.58 consensus against $1.35 a year earlier. The dividends endpoint gives the dividend calendar: the ex-dividend, record and payment dates, the per-share rate and the indicated annual dividend. The splits endpoint gives the stock-split calendar with the split ratio and execution date. This is the forward event-calendar layer every trading, portfolio, screener, earnings-tracker and finance app needs — read live from Nasdaq, nothing cached or stored. Pass any date as YYYY-MM-DD, or omit it for today. Distinct from price, quote and fundamentals APIs — this is the forward calendar of corporate events: who reports, who pays, who splits, and when. 4 endpoints. ## 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/marketcalendar-api/..." ``` ## Pricing - **Free** (Free) — 9,000 calls/Mo, 3 req/s - **Starter** ($11/Mo) — 110,000 calls/Mo, 8 req/s - **Pro** ($29/Mo) — 560,000 calls/Mo, 15 req/s - **Scale** ($68/Mo) — 2,800,000 calls/Mo, 30 req/s ## Endpoints ### Calendar #### `GET /v1/dividends` — Dividend calendar **Parameters:** - `date` (query, optional, string) — Trading day YYYY-MM-DD (default today) Example: `2026-06-10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/marketcalendar-api/v1/dividends?date=2026-06-10" ``` **Response:** ```json { "data": { "date": "2026-06-10", "type": "dividends", "count": 10, "events": [ { "name": "Auburn National Bancorporation, Inc. Common Stock", "symbol": "AUBN", "record_date": "6/10/2026", "payment_date": "6/25/2026", "dividend_rate": 0.27, "ex_dividend_date": "6/10/2026", "announcement_date": "5/12/2026", "indicated_annual_dividend": 1.08 }, { "name": "Brighthouse Financial, Inc. Depositary Shares 6.6% Non-Cumulative Preferred Stock, Series A", "symbol": "BHFAP", "record_date": "6/10/2026", "payment_date": "6/25/2026", "dividend_rate": 0.4125, "ex_dividend_date": "6/10/2026", "announcement_date": "5/15/2026", "indicated_annual_dividend": 1.65 }, { "name": "Brighthouse Financial, Inc. Depositary Shares 6.75% Non-Cumulative Preferred Stock, Series B", "symbol": "BHFAO", "record_date": "6/10/2026", "payment_date": "6/25/2026", "dividend_rate": 0.421875, "ex_dividend_date": "6/10/2026", "announcement_date": "5/15/2026", "indicated_annual_dividend": 1.6875 }, { "name": …(truncated, see openapi.json for full schema) ``` #### `GET /v1/earnings` — Earnings calendar **Parameters:** - `date` (query, optional, string) — Trading day YYYY-MM-DD (default today) Example: `2026-06-10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/marketcalendar-api/v1/earnings?date=2026-06-10" ``` **Response:** ```json { "data": { "date": "2026-06-10", "type": "earnings", "count": 27, "events": [ { "name": "Oracle Corporation", "symbol": "ORCL", "session": "after-hours", "estimates": 11, "market_cap": "$614,553,509,280", "eps_forecast": "$1.58", "last_year_eps": "$1.35", "fiscal_quarter_ending": "May/2026", "last_year_report_date": "6/11/2025" }, { "name": "Ferrovial N.V.", "symbol": "FER", "session": "not-supplied", "estimates": 2, "market_cap": "$48,066,972,411", "eps_forecast": null, "last_year_eps": "N/A", "fiscal_quarter_ending": "Mar/2026", "last_year_report_date": "N/A" }, { "name": "Ecopetrol S.A.", "symbol": "EC", "session": "not-supplied", "estimates": 2, "market_cap": "$31,145,896,235", "eps_forecast": "$0.60", "last_year_eps": "$0.36", "fiscal_quarter_ending": "Mar/2026", "last_year_report_date": "5/07/2025" }, { "name": "ICON plc", "symbol": "ICLR", "session": "not-supplied", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/splits` — Stock-split calendar **Parameters:** - `date` (query, optional, string) — Trading day YYYY-MM-DD (default today) Example: `2026-06-10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/marketcalendar-api/v1/splits?date=2026-06-10" ``` **Response:** ```json { "data": { "date": "2026-06-10", "type": "splits", "count": 6, "events": [ { "name": "Global Bio-chem Technology Group Company Limited ADR", "ratio": "1 : 10", "symbol": "GBCMY", "execution_date": "6/26/2026", "announcement_date": null }, { "name": "Siemens Energy AG", "ratio": "5 : 1", "symbol": "SMERY", "execution_date": "6/22/2026", "announcement_date": null }, { "name": "Chino Commercial Bancorp", "ratio": "6 : 5", "symbol": "CCBC", "execution_date": "6/18/2026", "announcement_date": null }, { "name": "Worldline ADR", "ratio": "1 : 40", "symbol": "WRDLY", "execution_date": "6/17/2026", "announcement_date": null }, { "name": "KLA Corporation ", "ratio": "10:1", "symbol": "KLAC", "execution_date": "6/12/2026", "announcement_date": null }, { "name": "Abound Energy Inc Com", "ratio": "1 : 3", "symbol": "ZAIRF", "execution_date": "6/10/2026", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/marketcalendar-api/v1/meta" ``` **Response:** ```json { "data": { "source": "Nasdaq public calendar API (live)", "service": "marketcalendar-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/splits": "Stock-split calendar on a date (date=YYYY-MM-DD): ratio, execution date.", "GET /v1/earnings": "Earnings reporting on a date (date=YYYY-MM-DD, default today): session, EPS forecast, estimates, market cap.", "GET /v1/dividends": "Dividend calendar on a date (date=YYYY-MM-DD): ex-dividend, record, payment dates, rate." }, "description": "Live US corporate-events calendar from Nasdaq: for any trading day, the earnings reporting (session, consensus EPS forecast, number of estimates, market cap, year-ago EPS), the dividend calendar (ex-dividend, record and payment dates, rate, indicated annual dividend) and the stock-split calendar (ratio, execution date). Live, nothing stored. Distinct from price and quote APIs — this is the forward calendar of corporate events.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-09T11:40:03.972Z", "request_id": "2cda2aa4-b75f-440c-80b3-75c6beab9f99" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/marketcalendar-api OpenAPI spec: https://www.oanor.com/api/marketcalendar-api/openapi.json