Release Calendar
release_calendarGet upcoming scheduled macroeconomic release timestamps for a currency, for questions such as when the next CPI, GDP, payrolls, or policy decision is due. Returns ISO-8601 announcement_datetime values in UTC plus market-local timestamps, a markdown agenda, and Release Calendar App metadata. The optional timezone adds an announcement_datetime_requested_timezone field. Each row has a release string with the indicator name and a currency code. Unbounded calls return future releases only. The optional indicator filter narrows to a single series, and optional start_date and end_date bounds select a month, week, day, or explicit date range. Supported currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. The indicator parameter lists the accepted indicator slugs. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"currency": "<currency>"
},
"name": "release_calendar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | upcoming (default): scheduled releases. snapshot: the schedule as it was known at `as_of`. versions: every schedule change and cancellation for one `archive_event_id`. archive_coverage: what we captured from each official calendar and the dates it covers, at `as_of` if given. | upcoming |
| as_of | No | snapshot and archive_coverage: ISO 8601 knowledge cutoff ending in Z or an offset. | |
| limit | No | snapshot/versions: page size, default 250. | |
| cursor | No | snapshot/versions: next_cursor from the previous page. | |
| currency | Yes | 3-letter ISO currency code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur. | |
| end_date | No | Optional inclusive upper bound, YYYY-MM-DD. | |
| timezone | No | Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo. | |
| indicator | No | Optional indicator slug to narrow results. Supported: catalogue indicator slug, e.g. inflation or policy_rate. | |
| checkpoint | No | snapshot/versions: checkpoint from the first page. | |
| event_kind | No | snapshot only: event kind filter. | |
| importance | No | snapshot only: importance filter. | |
| start_date | No | Optional inclusive lower bound, YYYY-MM-DD. | |
| knowledge_mode | No | snapshot only: accepted (default) or reconstruction. | |
| archive_event_id | No | versions only: the archive event_id from snapshot rows. |