Macro indicator

Query a macro indicator for a country.

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

Available data

Returns
Query a macro indicator for a country
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

Indicator and country

Choose the indicator and country; country_code is a compatible country selector

indicatorstringqueryExampleCPIrequired

Enter one macro indicator code (exact match). Common values: CPI, CORE_CPI, INFLATION_RATE, INFLATION_RATE_MOM, CORE_INFLATION_RATE, FEDERAL_FUNDS_RATE, GDP, GDP_GROWTH, GDP_ANNUAL_GROWTH, NONFARM_PAYROLL, UNEMPLOYMENT_RATE, LABOR_PARTICIPATION, CONSUMER_SPENDING, PPI, RETAIL_SALES, INDUSTRIAL_PRODUCTION, MONEY_SUPPLY_M2, CONSUMER_CONFIDENCE. Coverage varies by country or region

countrystringqueryExampleUnited Statesoptional

Country or region

Compatible aliases
country_codestringqueryoptional

Country or region code

Latest or history

latest returns snapshots; timeseries returns the available series. Date filters apply to timeseries

modestringqueryExamplelatestoptional

Query mode · latest / timeseries

Time range
fromstringqueryoptional

Range start

tostringqueryoptional

Range end

start_timestringqueryoptional

Inclusive UTC start; RFC3339, date or Unix seconds. Alias: from

end_timestringqueryoptional

Exclusive UTC end; a date-only value includes that UTC day. Alias: to

Return options
sizeintegerqueryExample3optional

Row limit · ≥ 1, ≤ 400

Response

dataobject

Response data

countnumber

Returned row count

countrystring

Country or region

duration_msnumber

duration_ms

indicatorstring

Macro indicator

latestobject

Latest metrics

snapshots[]object[]

Indicator snapshots

bea_series_codeunknown | null

bea_series_code

bls_series_idstring

bls_series_id

countrystring

Country or region

datedatetime

Date

event_typestring

event_type

fred_series_idstring

fred_series_id

indicatorstring

Macro indicator

indicator_cnstring

indicator_cn

modestring

Query mode

observation_datedatetime

observation_date

previousnumber

previous

reference_periodstring

Reference period

slugnamestring

slugname

sourcestring

source

timeseriesstring

timeseries

unitstring

Unit

valuenumber

Value

modestring

Query mode

sizenumber

Row limit

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.