Skip to content
Get started
Economic calendar
  1. REST reference
  2. Market context
  3. Economic calendar

Get one release

GET/public/v1/economic-calendar/{event_id}

The stored record for one release: event name, official release time, country and, once printed, the actual value.

PremiumAnnualLifetime

Request

curl "https://api.tradeeasyai.net/public/v1/economic-calendar/<event_id>" \
  -H "X-API-Key: $TRADEEASY_API_KEY"

Response shape

Field names and types; no sample values.

200 · application/json
{
  "success": true,
  "data": {
    "id": "<integer>",
    "event_name": "<string>",
    "event_date": "<string>",
    "country": "<string>",
    "actual_value": "<number>"
  },
  "meta": { "timestamp": "<string>", "request_id": "<string>" }
}

Parameters#

  • event_idintegerpathRequired

    A positive integer from events[].event_id.

Response fields#

  • idinteger

    The record id.

  • event_namestring

    Release name.

  • event_datestring · ISO 8601

    Official release time. raw_event_date carries the stored time when the two differ.

  • countrystring

    Country code.

  • actual_valuenumber | null

    The print, once released.

The record also carries TradeEasy’s forecast and its later scoring (predicted_*, confidence_score, *_accuracy); model outputs, documented by name only.

Errors#

  • 400INVALID_ID

    The id is empty, not a number, or not positive.

  • 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.

  • 404EVENT_NOT_FOUND

    No release has that id.

  • 429RATE_LIMIT_EXCEEDED

    Per-key minute or day bucket spent. Honour Retry-After.

  • 500FETCH_FAILED

    Unexpected read failure. Retry with backoff.

Educational market research, not investment advice; not for fully automated trade execution. Questions about the API or the MCP server: support@tradeeasyai.net.