Discovery and markets API

Macro calendar brief: the most important releases this week

The 60 most important economic releases due or just out (CPI, jobs, rates), with forecast, previous and actual.

GET/api/external/discovery/macro-calendar-brief

Get a free API key Try it in the API reference

What it returns

The brief of macro-calendar; prefer it unless you need every minor release. The same query: range, importance and country. It lists the 60 most important releases of the window, oldest first, each exactly as macro-calendar lists it, with how many releases the window holds at each importance. Raise importance or name a country to see every release of that kind.

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-brief"

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 Macro calendar brief: the most important releases this week
Field	Type	Description
`range`	string	The range answered.
`from`	integer	Start of the range, unix seconds.
`to`	integer	End of the range, unix seconds.
`eventCount`	integer	Releases in the full answer, after `importance` and `country`.
`eventsByImportance`	object[]	Releases in the full answer per importance, highest first; an importance with none is left out.
`eventsByImportance[].importance`	integer	1 low, 2 medium, 3 high.
`eventsByImportance[].eventCount`	integer	Releases at that importance.
`events`	object[]	The 60 most important releases, ties kept in time order, listed oldest first, each exactly as `macro-calendar` lists it.
`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.

Which macro releases (CPI, jobs, GDP, rates) are due or just out?
The full answer this one condenses
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