// Product Docs
Stable country-level macro series delivered through a managed API surface with explicit query contracts.
Macro Indicators provide country-level time series outputs intended for contextual monitoring, benchmark comparison, and macro framing rather than raw source mirroring.
Use geo_object_id as the primary contract key. The current strongest live package is COUNTRY_US.
Sample request
GET /v1/market/macro-daily?geo_object_id=COUNTRY_US
Sample response
{
"geo_object_id": "COUNTRY_US",
"series_id": "CPIAUCSL",
"macro_topic": "inflation",
"metric_date": "2026-02-01",
"avg_metric_value": 327.46
}The public macro surface keeps the request contract intentionally small.
| Parameter | Required | Description |
|---|---|---|
| geo_object_id | Yes | Primary contract key for the country-level macro package. |
Consumers should treat a macro row as a packaged observation rather than a direct source echo.
| Field | Meaning |
|---|---|
| geo_object_id | Contract key for country-level package lookup. |
| series_id | Source-aligned series identifier within the current macro package. |
| macro_topic | Product-facing topic grouping used for interpretation. |
| metric_date | Observation date carried by the delivery surface. |
| avg_metric_value | Packaged delivery value for the current surface. |
Freshness is tracked at the consumer layer. Integrators should rely on delivery freshness indicators rather than inferring recency only from upstream timestamps.
This product is live and stable, but its current live package is intentionally narrower than a full universal macro catalog. Build against the documented package boundary, not assumed global completeness.