Economic Calendar
Access global economic events and indicators.
The Economic Calendar API provides access to scheduled economic events, such as Interest Rate Decisions, GDP releases, and Employment reports.
- Endpoint:
/api/calendar - Method:
GET - Limit: Returns events within the specified date range.
| Name | Type | Required | Description |
|---|---|---|---|
startDate | integer | No | Start epoch timestamp (ms). Defaults to -3 days. |
endDate | integer | No | End epoch timestamp (ms). Defaults to +3 days. |
Note
[!TIP] This endpoint is ideal for filtering out volatility during major news events.
Returns an array of CalendarEvent objects.
[
{
"title": "Fed Interest Rate Decision",
"country": "US",
"importance": 1, // -1: Low, 0: Medium, 1: High
"ts": 1739991600000,
"actual": 5.25,
"forecast": 5.25,
"previous": 5.00,
"currency": "USD"
}
]import { CalendarApi } from "tickcatcher";
// 1. Get Economic Calendar Events
const events = await new CalendarApi(config).calendar({
startDate: Date.now(),
endDate: Date.now() + 86400000 * 7 // Next 7 days
});
console.log(`Found ${events.length} upcoming events.`);