Documentation

Everything you need to integrate economic data into your app. Get your first response in under 60 seconds.

Don't have an API key yet? It's free.

Get Free API Key

Quick Start

Sign up on RapidAPI

Create a free account at RapidAPI and subscribe to EconTrack. Your API key will be generated instantly.

Go to RapidAPI →

Make your first request

curl

curl "https://econ.econtrack.xyz/calendar?impact=high" \
  -H "X-API-Key: YOUR_API_KEY"

Parse the response

Returns a clean JSON array of economic events with actual, forecast, and previous values. Build your app.

JSON Response

{
  "events": [
    {
      "id": "us-cpi-2026-06",
      "name": "US CPI (YoY)",
      "country": "United States",
      "currency": "USD",
      "date": "2026-06-12",
      "impact": "high",
      "actual": "2.4%",
      "forecast": "2.3%",
      "previous": "2.5%",
      "source": "BLS",
      "category": "Inflation"
    }
  ],
  "count": 1
}

Authentication

All requests require an API key passed via the X-API-Key header. Subscribe on RapidAPI to get your key.

Header

X-API-Key: YOUR_API_KEY

RapidAPI Header (alternative)

If calling through RapidAPI directly, use their standard headers instead:

Header

X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: econ.econtrack.xyz

Base URL

https://econ.econtrack.xyz

GET /calendar

Retrieve economic events with flexible filtering by date range, country, impact level, and category.

Parameters

Name	Type	Required	Default	Example
start	string	No	today	2026-06-01
end	string	No	today + 30d	2026-06-30
country	string	No	all	US
impact	string	No	all	high
category	string	No	all	Inflation
limit	integer	No	50	10

Example Request

curl

curl "https://econ.econtrack.xyz/calendar?impact=high&country=US&limit=3" \
  -H "X-API-Key: YOUR_API_KEY"

GET /calendar/realtime

Events happening right now or within the next 24 hours that have just received actual data. Ideal for live dashboards and alerts.

Name	Type	Required	Default
impact	string	No	all

GET /calendar/history

Historical economic events with actual vs. forecast data. Useful for backtesting trading strategies and trend analysis.

Name	Type	Required	Default	Example
days	integer	No	30	90
country	string	No	all	US
impact	string	No	all	high

GET /calendar/upcoming

Future scheduled economic events with forecast data. Perfect for event-countdown features and planning tools.

Name	Type	Required	Default
days	integer	No	14
impact	string	No	all
limit	integer	No	20

GET /events/{id}

Retrieve a single economic event by its unique ID.

Name	Type	Required	Example
id	string	Yes	us-nfp-2026-06

Example

curl "https://econ.econtrack.xyz/events/us-nfp-2026-06" \
  -H "X-API-Key: YOUR_API_KEY"

GET /countries

List all supported countries with available data sources.

Example

curl "https://econ.econtrack.xyz/countries" \
  -H "X-API-Key: YOUR_API_KEY"

Response Schema

All event objects in API responses follow this structure:

Field	Type	Description	Example
id	string	Unique event identifier	us-cpi-2026-06
name	string	Human-readable event name	US CPI (YoY)
country	string	Country name	United States
currency	string	Currency code	USD
date	string	Event date (ISO 8601)	2026-06-12
time	string	Event time (if known)	08:30
impact	string	Impact level	high \| medium \| low
actual	string	Published actual value	2.4%
forecast	string	Market forecast	2.3%
previous	string	Previous release value	2.5%
source	string	Data source	BLS
category	string	Event category	Inflation
has_forecast	boolean	Whether forecast data exists	true
exact_time_known	boolean	Whether exact time is known	true
updated_at	string	Last update timestamp (ISO 8601)	2026-06-12T08:31:00Z

Error Codes

Code	Meaning
200	Success
400	Bad request — invalid parameters
401	Unauthorized — missing or invalid API key
404	Event not found
429	Rate limit exceeded
500	Server error

Rate Limits

Tier	Requests/Hour	Daily Limit
Free	10	—
Basic	100	—
Pro	1,000	—
Enterprise	Unlimited	—

Rate Limit Headers

Every response includes these headers so you can manage your quota:

Header	Description	Example
X-RateLimit-Limit	Max requests allowed per hour	100
X-RateLimit-Remaining	Requests remaining in current window	87
X-RateLimit-Reset	UTC epoch time when window resets	1750000000

Code Examples

Full working examples for the /calendar endpoint.

curl

Python

JavaScript

PHP

curl

curl "https://econ.econtrack.xyz/calendar?impact=high&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

url = "https://econ.econtrack.xyz/calendar"
headers = {"X-API-Key": "YOUR_API_KEY"}
params = {"impact": "high", "limit": 10}

resp = requests.get(url, headers=headers, params=params)
data = resp.json()

for event in data["events"]:
    print(f"{event['date']} | {event['name']} | {event['forecast']}")

JavaScript

const resp = await fetch(
  "https://econ.econtrack.xyz/calendar?impact=high&limit=10",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await resp.json();

data.events.forEach(e => {
  console.log(`${e.date} | ${e.name} | ${e.forecast}`);
});

PHP

$url = "https://econ.econtrack.xyz/calendar?impact=high&limit=10";
$opts = [
  "http" => [
    "header" => "X-API-Key: YOUR_API_KEY"
  ]
];
$ctx = stream_context_create($opts);
$resp = file_get_contents($url, false, $ctx);
$data = json_decode($resp, true);

foreach ($data["events"] as $e) {
  echo $e["date"] . " | " . $e["name"] . " | " . $e["forecast"] . "\n";
}