Economics

Sugra Macro - cross-country economic indicators panel

Changed on

Time series for one or more indicators across one or more countries. Pass indicator roots (e.g. GDP, CPI, URATE, GBAL for the budget balance or deficit, EXP for exports - discover them via the indicators catalog) as symbol, and country names or ISO codes as country; both accept comma-separated lists. Optional transform: toya (YoY), tpop (period change), tpgp (percent of GDP), tusd (USD). Percent series are returned as normalized fractions (0.05 = 5%).

get/api/v1/macro/indicators

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/macro/indicators
  • Auth: API key in header x-api-key

Query parameters

symbolstring required

Indicator root(s), comma-separated (e.g. GDP or GDP,CPI). Max 6.

Example:GDP
countrystring required

Country name(s) or ISO code(s), comma-separated. Max 12.

Example:united_states
transformstring nullable

Optional transform: toya, tpop, tpgp, or tusd.

Example:toya
start_datestring nullable

Inclusive lower bound (YYYY-MM-DD).

end_datestring nullable

Inclusive upper bound (YYYY-MM-DD).

Response

Indicator observations (date, symbol_root, symbol, country, value).

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes