Economic data

The forward economic calendar

Changed on

Economic releases with forecasts, prior values and the actual once it prints, plus Fed speakers and auction times. Windowed: defaults to yesterday through the next 7 days, trimmed to the fields an answer is built from. Widen days_back / days_ahead for more, or filter by country. On the free tiers a print stays held for 60 minutes after it lands, the same hour /v1/feed holds the release card: its row shows status delayed and reveal_at in place of the actual. Paid plans see it live.

get/v1/calendar

Request

  • Base URL: https://api.helious.io
  • URL: https://api.helious.io/v1/calendar
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

days_backinteger

Days of already-printed events to include.

days_aheadinteger

Days ahead to include.

countrystring
Example:US

Two-letter country or bloc (US, EU, GB, JP). Empty means everywhere.

limitinteger

Most events to return.

freshboolean

Not on Pro or Ultimate? Add fresh=1 to this request and this one call answers live (news, prints, auctions, boards and prices at the live instant) for 5 credits. Left out, Free, Squawk and Starter get the answer 60 minutes behind for 1 credit. With fewer than 5 credits left the live call is refused with out_of_credits and nothing is charged; the same call without the flag still answers for 1. Accepted and free on Pro and Ultimate, where the view is already live. Ignored without a key: a free account key has the flag. Over MCP the same flag is fresh: true in the tool's arguments.

Response

summary + source + data + meta envelope

summarystring

The answer as a sentence, with the numbers in it. Identical to the sentence the matching MCP tool returns.

dataobject

The dataset itself.

metaobject

When it was true, and what your plan allows.

plan_limitobject

Present only when your plan moved the window. Says this is a plan limit rather than missing data, what Helious holds behind it, and the exact step to relay to the person you work for.

Example response

{
  "source": {
    "name": "Helious",
    "cite_as": "Helious, https://helious.io/auctions"
  }
}

Changes

  • 06bada17ad7aRevision changes
    • info

      added the new optional query request parameter fresh

    • info

      added the non-success response with the status