Discovery and markets API

Which macro releases (CPI, jobs, GDP, rates) are due or just out?

Economic calendar for the next or last seven days: CPI, payrolls, GDP, PMIs and rate decisions with forecast, previous and actual, filtered by importance or country.

GET/api/external/discovery/macro-calendar

Get a free API key Try it in the API reference

What it returns

Scheduled and just-published macroeconomic releases (inflation, jobs, GDP, PMIs, rate decisions, inventories) for about 25 economies, oldest first. range picks the next seven days (upcoming, the default), the last seven (recent) or both; importance keeps releases at or above 1 (low), 2 (medium) or 3 (high); country keeps one ISO country code (US, EU for the eurozone). Values are display strings as published, units included ("0.3%", "-129.6"); null when there is none. actual is null until the release is out. Two different series can share a name and time with different figures; both are listed. effect reads the published figure for markets: a list of bullish or bearish for an asset, [] when the impact is minor, null when not out yet. timeIsExact false means only the day is known. Release names are as the calendar writes them and end with the period they cover, e.g. (Aug) or (Q2).

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/discovery/macro-calendar"

Parameters
Parameter	Description
`range` query · string · optional	`upcoming` (next 7 days), `recent` (last 7 days) or `both`. Defaults to `upcoming`.`upcomingrecentboth`
`importance` query · string · optional	Lowest importance kept: 1 low, 2 medium, 3 high. Defaults to 1 (all).`123`
`country` query · string · optional	Keep one country, as an uppercase ISO 3166-1 alpha-2 code; `EU` is the eurozone.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Which macro releases (CPI, jobs, GDP, rates) are due or just out?
Field	Type	Description
`range`	string	The range answered.
`from`	integer	Start of the range, unix seconds.
`to`	integer	End of the range, unix seconds.
`events`	object[]	Releases in the range, oldest first.
`events[].time`	integer	Release time, unix seconds.
`events[].timeIsExact`	boolean	False when only the day is known.
`events[].country`	string	Country or area name.
`events[].countryCode`	string \| null	ISO 3166-1 alpha-2 code, `EU` for the eurozone; `null` if unknown.
`events[].name`	string	The release, ending with the period it covers.
`events[].importance`	integer	1 low, 2 medium, 3 high.
`events[].forecast`	string \| null	Consensus forecast, as published.
`events[].previous`	string \| null	The previous release's figure.
`events[].revisedPrevious`	string \| null	The previous figure as revised in this release, when it was.
`events[].actual`	string \| null	The published figure; `null` until it is out.
`events[].effect`	object[] \| null	What the figure means for markets; `[]` minor impact, `null` not out yet or not read.
`events[].effect[].direction`	string
`events[].effect[].asset`	string	e.g. `US dollar`, `euro`, `crude oil`, `gold and silver`.

Price per call

Every call: 6 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

Macro calendar brief: the most important releases this week
The same answer in a compact response
Is the crypto market greedy or fearful, and is it altcoin season?
How the market feels going into a release.
Which protocols were hacked, when, for how much, and how?
Crypto hacks, exploits and rugpulls back to 2011: who was hit, the day, the USD taken and returned, the technique and the chains, filtered by date or size.
Which tokens unlock supply soon, how much and when?
Each tracked token's next scheduled unlock, soonest first: the day, the tokens, their USD value and how big the unlock is against the float, filtered by date or size.
What is this spot exchange, and what does it trade?
One spot exchange: centralized or on-chain, trust score, 24h volume, country, and its 100 largest markets with price, volume and spread. Addressed by id; no chain.
How has this exchange's trading volume moved over time?
One spot exchange's 24h volume in BTC over the last day (every 10 minutes), 7 or 14 days (hourly) or 30 to 365 days (daily). Addressed by exchange id; no chain.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key