- REST reference
- Market context
- Economic calendar
List upcoming releases
GET/public/v1/economic-calendar
Scheduled economic releases for one country over the next days, each with its release time, consensus and previous print, and the id of its stored record when there is one.
Request
curl "https://api.tradeeasyai.net/public/v1/economic-calendar?country=US&days_ahead=7" \
-H "X-API-Key: $TRADEEASY_API_KEY"Response shape
Field names and types; no sample values.
{
"success": true,
"data": {
"country": "<string>",
"days_ahead": "<integer>",
"events": [ … ],
"total": "<integer>"
},
"meta": { "timestamp": "<string>", "request_id": "<string>" }
}Parameters#
- countrystringquery
Country code, 1 to 8 characters. Default US.
- days_aheadintegerquery
Days ahead, 1 to 90. Default 30.
Response fields#
- countrystring
The country you asked for, upper-cased.
- days_aheadinteger
The window you asked for.
- events[].indicatorstring
Release name.
- events[].release_datestring
Scheduled release time.
- events[].consensus_estimatenumber | null
Market consensus.
- events[].previous_valuenumber | null
The previous print.
- events[].event_idinteger | null
Id for /economic-calendar/{event_id}; null when the release has no stored record yet.
- totalinteger
Number of events returned.
Each event also carries TradeEasy’s own pre-release view (scenarios, confidence_score, ai_reasoning) and beat_miss_history; model outputs, documented by name only.
Errors#
- 401detail
Missing, invalid or revoked key, or a locked account. FastAPI {"detail": …} body, not the envelope.
- 403detail
The plan does not include the REST API, or the subscription is not active.
- 422detail[]
A query value is outside its range (FastAPI validation).
- 429RATE_LIMIT_EXCEEDED
Per-key minute or day bucket spent. Honour Retry-After.
- 500FETCH_FAILED
Unexpected read failure. Retry with backoff.