---
title: "Macro indicator map"
method: GET
path: "/v1/embed/macro/map"
tags: ["Embed"]
---

# Macro indicator map

`GET /v1/embed/macro/map`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/embed/macro/map`
- Auth: none required

Anonymous, cacheable annual country-by-period matrix for one macro indicator, plus a bounded recent-monthly overlay. Series carry root-source labels.

## Query parameters

- `indicator` 'inflation-rates' | 'interest-rates' | 'gdp' | 'unemployment-rate' | 'debt-to-gdp' | 'balance-of-trade', required

## Response `200`

Successful response

- EmbedMacroMap
  - `object` 'embed_macro_map', required
  - `contractVersion` 'v1', required
  - `indicator` 'inflation-rates' | 'interest-rates' | 'gdp' | 'unemployment-rate' | 'debt-to-gdp' | 'balance-of-trade', required
  - `unit` string, required
  - `asOf` string, required
  - `source` 'World Bank' | 'International Monetary Fund' | 'Bank for International Settlements' | 'International Labour Organization' | 'Organisation for Economic Co-operation and Development' | 'U.S. Energy Information Administration' | 'National statistics office' | 'Central bank', required
  - `annual` object[], required
    - `period` string, required
    - `frequency` 'annual', required
    - `values` object, required
  - `monthlyOverlay` object[], required
    - `period` string, required
    - `frequency` 'monthly', required
    - `values` object, required
  - `aggregates` object[], required
    - `code` '1W' | 'OE', required
    - `label` string, required
    - `period` string, required
    - `value` number, nullable, required
    - `source` 'World Bank' | 'International Monetary Fund' | 'Bank for International Settlements' | 'International Labour Organization' | 'Organisation for Economic Co-operation and Development' | 'U.S. Energy Information Administration' | 'National statistics office' | 'Central bank', required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)