Sugra Macro direction

The official economic record - central banks, statistical agencies, global trade - normalized into one API.

Sugra Macro covers monetary policy, official statistics, international trade, public finance and the US Treasury market. Every upstream in this direction is a sovereign institution, an intergovernmental organization or an academic project, so all sources are named openly: the Federal Reserve, ECB, BIS, IMF, OECD, World Bank, WTO, UN Comtrade, the US Treasury and national statistical offices across 17 countries. Responses share the standard data + meta envelope; meta.source identifies the upstream on every call.

What data lives here

API Reference category	Endpoints	Coverage
Central Banks & Monetary	268	Federal Reserve (policy rates, SOMA, H.4.1/H.6/H.8, primary dealers), FRED series, ECB datasets and yield curve, BIS statistics, and national central banks including the Bank of Japan, Bank of Canada, Swiss National Bank, Sveriges Riksbank, Norges Bank and Banco Central do Brasil
Statistical Agencies	165	National statistical offices: BEA, Census Bureau, Eurostat, Destatis, INSEE, Spain INE, UK ONS, e-Stat Japan, ABS Australia, StatCan and more, plus ILOSTAT labor statistics - CPI, GDP, unemployment, industrial production, retail sales
Global Economy & Trade	80	IMF (SDMX dataflows, country overviews, direction of trade), World Bank, OECD, WTO, UN Comtrade, WITS, Global Trade Alert
Public Finance & Government	66	US Treasury fiscal data (debt, auctions, rates, daily statement, deficit), USAspending, Congress.gov, government open-data portals
Fixed Income	19	The `/api/v2` Treasury market surface: par and GSW yield curves, TIPS curve, per-CUSIP prices, returns and curve risk, reference rates, auction calendar and results

Counts reflect the live catalog as of 2026-07-18. The Economics category adds composed country overviews and the /api/v1/macro cross-country indicator panel used below.

Flagship endpoints

FRED series observations

GET /api/v1/fred/series/{series_id} returns observations for any FRED series - CPI, GDP, unemployment, federal funds rate, M2 and roughly 800k more.

Response (truncated):

{
  "data": {
    "series_id": "CPIAUCSL",
    "title": "Consumer Price Index for All Urban Consumers: All Items in U.S. City Average",
    "units": "Index 1982-1984=100",
    "frequency": "Monthly",
    "count": 3,
    "observations": [
      {"date": "2026-06-01", "value": 332.568},
      {"date": "2026-05-01", "value": 333.979},
      {"date": "2026-04-01", "value": 332.407}
    ]
  },
  "meta": {"endpoint": "/api/v1/fred/series/CPIAUCSL", "source": "fred"}
}

Supports observation_start, observation_end, frequency, aggregation_method and units transforms.

Central bank policy rates

GET /api/v1/bis/cb-rates returns the latest policy rate for every country in the BIS policy-rate dataset in one call.

Response (truncated):

{
  "data": [
    {"REF_AREA": "BR", "REF_AREA_name": "Brazil", "TIME_PERIOD": "2026-06", "value": 14.25},
    {"REF_AREA": "AR", "REF_AREA_name": "Argentina", "TIME_PERIOD": "2025-06", "value": 29},
    {"REF_AREA": "CO", "REF_AREA_name": "Colombia", "TIME_PERIOD": "2026-06", "value": 11.25}
  ]
}

GET /api/v1/bis/cb-rates/{country} returns the history for a single country; last_n controls depth.

Cross-country indicator panel

GET /api/v1/macro/indicators composes one indicator across countries from the underlying statistical agencies, harmonized into a single panel.

Response (truncated):

{
  "data": {
    "count": 172,
    "results": [
      {"date": "2012-03-01", "symbol_root": "CPI", "symbol": "CPIDE", "country": "Germany", "value": 91.7},
      {"date": "2012-04-01", "symbol_root": "CPI", "symbol": "CPIDE", "country": "Germany", "value": 91.6}
    ]
  }
}

country accepts comma-separated lists, and /api/v1/macro/catalog lists every available symbol per country.

US Treasury yield curve

GET /api/v2/fixed-income/treasury/yield-curve returns the daily par yield curve; the Fixed Income category adds GSW and TIPS curves, per-CUSIP analytics and auction data.

Response (truncated):

{
  "data": {
    "dataset": "par_yield",
    "curve_type": "nominal",
    "date": "2026-07-17",
    "points": [
      {"tenor": "1M", "tenor_months": 1.0, "yield": 3.73},
      {"tenor": "2Y", "tenor_months": 24.0, "yield": 4.18},
      {"tenor": "10Y", "tenor_months": 120.0, "yield": 4.55},
      {"tenor": "30Y", "tenor_months": 360.0, "yield": 5.06}
    ]
  },
  "meta": {"source": "us_treasury"}
}

Typical workflows

AI agents grounding economic claims in the official record: fetch the current policy rate, CPI print or GDP series and cite meta.source instead of relying on model memory.

Research desks and dashboards building cross-country panels without maintaining separate SDMX clients for each central bank and statistical office.

Rates monitoring: join the daily Treasury curve and auction calendar with FRED history and BIS policy rates for a full picture of the rate cycle.

Where to go next

Sources: the Sugra Macro sources page lists every upstream institution with tier and license.

API Reference: the sidebar categories Central Banks & Monetary, Statistical Agencies, Global Economy & Trade, Public Finance & Government and Fixed Income document every endpoint with parameters and schemas.

Quickstart covers authentication, the response envelope and rate-limit headers.

Sugra Macro direction

What data lives here#

Flagship endpoints#

FRED series observations#

Central bank policy rates#

Cross-country indicator panel#

US Treasury yield curve#

Typical workflows#

Where to go next#

What data lives here

Flagship endpoints

FRED series observations

Central bank policy rates

Cross-country indicator panel

US Treasury yield curve

Typical workflows

Where to go next