Macro summary

Get key macro indicators and upcoming economic events.

GET/api/v1/fundamentals/macro-summary
Domain
Fundamentals
Level
Aggregate
MCP tool
fundamentals_query (task=macro_summary)

Available data

Returns
Get key macro indicators and upcoming economic events
What each request returns
Query the data selected by the endpoint parameters.

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Response

dataobject

Response data

countnumber

Returned row count

duration_msnumber

duration_ms

indicatorsobject

Indicator names

cpi_yoyobject

Consumer price indicator

referencestring

Reference period

trendstring

Trend

unitstring

Unit

valuenumber

Value

federal_funds_rateobject

Federal funds rate

referencestring

Reference period

trendstring

Trend

unitstring

Unit

valuenumber

Value

gdp_growthobject

GDP indicator

referencestring

Reference period

trendstring

Trend

unitstring

Unit

valuenumber

Value

nonfarm_payrollobject

Nonfarm payroll indicator

referencestring

Reference period

trendstring

Trend

unitstring

Unit

valuenumber

Value

pce_yoyobject

Personal consumption expenditure indicator

referencestring

Reference period

trendstring

Trend

unitstring

Unit

valuenumber

Value

unemployment_rateobject

Unemployment rate

referencestring

Reference period

trendstring

Trend

unitstring

Unit

valuenumber

Value

indicators_totalnumber

indicators_total

next_events[]object[]

next_events

event_datedatetime

event_date

event_idstring

event_id

event_namestring

event_name

event_timestring

event_time

event_typestring

event_type

statement_urlstring

statement_url

statusstring

status

snapshot_timedatetime

Observation time

totalnumber

Total matching records

data_statusDataStatus

Data status

empty_reasonunknown | null

Reason for an empty result

errorunknown | null

Structured error; null when absent

external_refs[]unknown[]

external_refs

lineage_refs[]unknown[]

lineage_refs

metadataobject

Response metadata

actual_taskstring

actual_task

data_statusDataStatus

Data status

limitations[]unknown[]

Additional information

object_refs[]unknown[]

object_refs

route_reasonstring

route_reason

updated_atdatetime

Data update time

request_idstring

Request identifier

source_refs[]unknown[]

source_refs

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.