Skip to content
GET /v1/meta

Spec

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/economiccalendar-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/economiccalendar-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/economiccalendar-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/economiccalendar-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/economiccalendar-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "source": "Nasdaq public economic calendar API (live)",
        "service": "economiccalendar-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/week": "The whole week ahead from a date (date=, optional country=, q=).",
            "GET /v1/events": "Economic events on a date (date=YYYY-MM-DD, optional country=, q=event name).",
            "GET /v1/countries": "Which countries report on a date and how many events each (date=)."
        },
        "description": "Live macroeconomic-event calendar from Nasdaq: for any date, each release with GMT time, country, event name, actual print, consensus forecast, previous reading and a description — GDP, CPI/inflation, central-bank rate decisions, unemployment/NFP, industrial production, trade balances, PMI and more, across every major economy. Filter by country or event name, get the whole week ahead in one call, or see which countries report on a date. Live, nothing stored. Distinct from corporate-events (earnings/dividends/splits) and price APIs — this is the macroeconomic calendar.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:57.901Z",
        "request_id": "5f9bcf0f-92c6-46ef-857c-6e0d391f21b5"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}