Don't invest unless you're prepared to lose all the money you invest. This is a high-risk investment and you should not expect to be protected if something goes wrong. Take 2 mins to learn more.

DecryptrDevelopers
News and events

Economic calendar

get/v1/calendar

https://data.decryptr.ai/v1/calendar

  • API planStarter and above
  • Scopecalendar:read
  • Cost1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. How units are counted
  • CreditEconomic calendar schedule and figures from TradingView.

Rate limits by plan

PlanUnits a monthPer secondPer minuteMost per request
Starter50,00056025
Pro300,0001530050
Business1,500,00040900100
EnterpriseAgreedAgreedAgreedAgreed

A 429 carries the full rate-limit header set and a Retry-After. Rate limits

Errors

  • 400The request was refused before any data was read. Nothing is charged.
  • 401No usable key. Nothing is charged.
  • 402The account cannot use the API until billing is sorted. Nothing is charged.
  • 403The key may not use this endpoint. Nothing is charged.
  • 429A limit was reached (units or streams). Nothing was read and nothing is charged. Wait Retry-After seconds, back off with jitter, or ask for fewer items.
  • 500Something failed on our side. Nothing is charged. Retry with backoff.
  • 503The API is switched off, busy, or a query ran too long. Nothing is charged. Retry after Retry-After seconds.

Errors follow RFC 9457. Every error code

The economic releases Decryptr runs event rooms for (US CPI, FOMC, jobs report, PCE, and token unlocks), soonest first, with forecast, previous and actual as published. Past events go back as far as your plan's history; future events are always included. Schedule and figures from TradingView: keep the attribution line.

Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back.

Needs scope calendar:read and the starter plan or above.

Authorization

headerAuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>

Your API key as a Bearer token: Authorization: Bearer dcr_live_....

Query Parameters

from?string

Events at or after this time (ISO 8601). Defaults to the start of your plan's history.

Formatdate-time
to?string

Events before this time.

Formatdate-time
country?string

Two-letter country code.

Match^[A-Z]{2}$
importance?string

low, medium or high.

Value in"low""medium""high"
cursor?string

next_cursor from the previous page, passed back as it is. Opaque: do not build or change it.

Lengthlength <= 300
limit?integer

Items to return, 1 to 100. Your plan allows max_page units per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's units per item. Default 20, or that maximum if lower. The request reserves limit x units per item before it runs: ask only for what you need.

Range1 <= value <= 100

Response Body

OK.

application/json
  1. response
data*array<>
as_of*string

When the response was made.

Formatdate-time
next_cursor*|

Pass as cursor for the next page. null when this is the last page.

attribution*string

Attribution you must keep with this data.

disclaimer*string

Plain-language notice. Information only, not financial advice.

curl -X GET 'https://data.decryptr.ai/v1/calendar?from=2026-10-20T00%3A00%3A00Z&to=2026-11-30T00%3A00%3A00Z&country=US&importance=high&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'
Example Response
{  "data": [    {      "id": "US|cpi|2026-08-24T12:30Z",      "kind": "macro",      "title": "US CPI",      "country": "US",      "importance": "high",      "asset": null,      "event_at": "2026-08-24T12:30:00.000Z",      "status": "closed",      "forecast": "0.3",      "previous": "0.2",      "actual": "0.3",      "updated_at": "2026-08-24T12:30:00.000Z"    },    {      "id": "US|fomc|2026-08-27T12:30Z",      "kind": "macro",      "title": "FOMC rate decision",      "country": "US",      "importance": "high",      "asset": null,      "event_at": "2026-08-27T12:30:00.000Z",      "status": "closed",      "forecast": "0.3",      "previous": "0.2",      "actual": "0.3",      "updated_at": "2026-08-27T12:30:00.000Z"    },    {      "id": "US|nfp|2026-08-30T12:30Z",      "kind": "macro",      "title": "US jobs report",      "country": "US",      "importance": "high",      "asset": null,      "event_at": "2026-08-30T12:30:00.000Z",      "status": "closed",      "forecast": "0.3",      "previous": "0.2",      "actual": "0.3",      "updated_at": "2026-08-30T12:30:00.000Z"    }  ],  "next_cursor": "eyJ0IjoiMjAyNi0wOC0zMFQxMjozMDowMC4wMDBaIiwiaCI6IlVTfG5mcHwyMDI2LTA4LTMwVDEyOjMwWiJ9",  "as_of": "2026-10-23T12:15:30.000Z",  "attribution": "Economic calendar schedule and figures from TradingView.",  "disclaimer": "Information only, not financial advice or a recommendation."}