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	218	National statistical offices: BEA, Census Bureau, Eurostat, Destatis, INSEE, Statistics Netherlands (CBS), Swiss Federal Statistical Office (FSO), Statistics Poland (GUS), Italian National Institute of Statistics (ISTAT), Spain INE, UK ONS, e-Stat Japan, ABS Australia, StatCan and more, plus ILOSTAT labor statistics - CPI, GDP, unemployment, industrial production, retail sales; Eurostat PRODCOM production by product
Global Economy & Trade	104	IMF (SDMX dataflows, country overviews, direction of trade), World Bank, OECD, WTO, UN Comtrade, WITS, Global Trade Alert; US merchandise trade from the Census Bureau by partner, commodity, state, port and end use; daily transits through 28 maritime chokepoints (IMF PortWatch) with the Panama Canal Authority's own transit count and the JMIC advisory counts
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-09-27. 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. With a units transform other than lin, units and units_short name the transform (for example Percent Change from Year Ago) and the series' own labels move to level_units and level_units_short.

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"}
}

US trade by partner and commodity

GET /api/v1/census/trade/flows returns the monthly US export or import series for one partner and one commodity, from the US Census Bureau's international trade data. partner takes a Census country code (5700 is China) or world, commodity an HS code of 2, 4 or 6 digits or all, and from and to a month from 2013-01 on. Values are in US dollars: exports at FAS value, imports at the customs value of general imports.

Response (truncated):

{
  "data": {
    "flow": "imports",
    "partner": {"code": "5700", "name": "CHINA", "kind": "country"},
    "commodity": {"code": "27", "level": "HS2", "description": "MINERAL FUEL, OIL ETC.; BITUMIN SUBST; MINERAL WAX"},
    "unit": "USD",
    "data": [
      {"month": "2025-01", "value": 41327254, "value_ytd": 41327254, "cif_value": 44556615},
      {"month": "2025-02", "value": 38605430, "value_ytd": 79932684, "cif_value": 40649597}
    ],
    "source": "US Census Bureau"
  },
  "meta": {"endpoint": "/api/v1/census/trade/flows", "source": "census"}
}

The same family answers one month across partners (/api/v1/census/trade/by-partner), commodities (/api/v1/census/trade/by-commodity), states (/api/v1/census/trade/by-state), customs ports (/api/v1/census/trade/by-port), end-use categories (/api/v1/census/trade/by-end-use) and advanced-technology groups (/api/v1/census/trade/by-hitech), and /api/v1/census/trade/balance returns the monthly trade balance with a partner. /api/v1/census/trade/partners and /api/v1/census/trade/commodities list the codes.

EU production by product (PRODCOM)

GET /api/v1/eurostat/prodcom returns Eurostat's PRODCOM statistics for one 8-digit product code in one reporting country: sold production value and quantity, with exports and imports of the same product, yearly from 1995. Eurostat publishes the years to 2024 and the years from 2025 as two datasets under two classifications. Where the 2025 classification split or renamed a code, the response follows the EU linking table to its successor codes and says so in product.classification_break. /api/v1/eurostat/prodcom/codes?q= finds a code by its label.

Response (truncated):

{
  "data": {
    "product": {
      "code": "26112240",
      "label": "Photosensitive semiconductor devices; solar cells, photo-diodes, photo-transistors, etc.",
      "split": true,
      "classification_break": "this code ends in 2024; the EU PRODCOM 2024-2025 linking table splits it into 26112310, 26112230, 26112210"
    },
    "reporter": {"code": "DE"},
    "count": 4,
    "data": [
      {"period": "2024", "product": "26112240", "dataflow": "DS-059358", "relation": "requested",
       "exports_value": 1167559476, "imports_value": 2627265350, "sold_production_quantity": 33616755},
      {"period": "2025", "product": "26112230", "dataflow": "DS-059367", "relation": "successor",
       "exports_value": 356829713, "imports_value": 1786975643, "sold_production_value": 70770000}
    ],
    "source": "Eurostat"
  },
  "meta": {"endpoint": "/api/v1/eurostat/prodcom", "source": "eurostat"}
}

A field Eurostat keeps confidential comes back as a _flag field (for example sold_production_value_flag: ":C") in place of the value.

Maritime chokepoints

GET /api/v1/maritime/chokepoints/activity returns daily transits by vessel type through 28 maritime chokepoints, from IMF PortWatch. chokepoint_id selects one (chokepoint1 is the Suez Canal); /api/v1/maritime/chokepoints lists all 28 with their ids. The counts come from vessel AIS signals, so a vessel sailing without a usable signal is not counted, and each response carries a data_quality block that compares the last 30 days with the same window a year earlier.

Response (truncated):

{
  "data": {
    "count": 2,
    "entries": [
      {"date": "2026-09-20", "portname": "Suez Canal", "n_container": 14, "n_dry_bulk": 7, "n_tanker": 19, "n_total": 42},
      {"date": "2026-09-19", "portname": "Suez Canal", "n_container": 10, "n_dry_bulk": 10, "n_tanker": 13, "n_total": 43}
    ],
    "data_quality": {
      "assessment": "compared",
      "window": {"days": 30, "start": "2026-08-22", "end": "2026-09-20"},
      "series": {"chokepoint1": {"status": "comparable", "ratio": 0.9943}}
    }
  },
  "meta": {"endpoint": "/api/v1/maritime/chokepoints/activity", "source": "imf_portwatch"}
}

Other routes in the family carry records that do not depend on AIS, each from the institution that keeps it:

/api/v1/maritime/chokepoints/panama/transits: the Panama Canal Authority's daily count of the transits it authorised, by vessel class and direction.

/api/v1/maritime/chokepoints/jmic/advisory: the transit counts in the Joint Maritime Information Center advisory for the Strait of Hormuz and Bab el-Mandeb.

/api/v1/maritime/chokepoints/hormuz/transits: UKMTO's weekly count of full transits through the Strait of Hormuz.

/api/v1/maritime/chokepoints/hormuz/gulf-exports: Gulf crude exports as reported to JODI.

/api/v1/maritime/chokepoints/hormuz/import-floor: a minimum number of daily transits implied by recorded crude imports, from Japan METI and Eurostat.

/api/v1/maritime/chokepoints/malacca/throughput: vessel arrivals, departures and expected arrivals at Singapore, from the Maritime and Port Authority of Singapore. Singapore sits at the eastern end of the Strait of Malacca, so this is port throughput, not a count of strait transits.

Each response states what its figure covers and what it cannot show.

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.

Trade and supply-chain analysis: set EU production of a product (PRODCOM) and US imports by partner beside the daily transit counts at the chokepoints on a trade route. The chokepoint counts are by vessel type, so they show traffic on the route, not which product or shipment passed.

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#

US trade by partner and commodity#

EU production by product (PRODCOM)#

Maritime chokepoints#

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

US trade by partner and commodity

EU production by product (PRODCOM)

Maritime chokepoints

Typical workflows

Where to go next