Economic Service

Access macroeconomic data from FRED, World Bank, EIA, and BIS

Overview

The Economic Service provides comprehensive APIs for macroeconomic data from multiple authoritative sources including the Federal Reserve Economic Data (FRED), World Bank, U.S. Energy Information Administration (EIA), and Bank for International Settlements (BIS).

Base Path: /api/economic/v1

---

GetFredSeries

Retrieves time series data from the Federal Reserve Economic Data.

Endpoint: GET /api/economic/v1/get-fred-series

Request Parameters

series_id · string · required

FRED series ID (e.g., “GDP”, “UNRATE”, “CPIAUCSL”).

limit · integer

Maximum number of observations to return. Defaults to 120.

Response

series · object

The FRED time series.

Show FredSeries

series_id · string · required

Series identifier.

title · string

Series title.

units · string

Unit of measurement.

frequency · string

Data frequency (e.g., “Monthly”, “Quarterly”).

observations · array

Observations in the series.

Show FredObservation

date · string

Observation date as YYYY-MM-DD string.

value · number

Observation value.

Example Request

curl -X GET "https://api.worldmonitor.com/api/economic/v1/get-fred-series?series_id=GDP&limit=20"

Example Response

{
  "series": {
    "series_id": "GDP",
    "title": "Gross Domestic Product",
    "units": "Billions of Dollars",
    "frequency": "Quarterly",
    "observations": [
      {"date": "2023-Q1", "value": 26470.3},
      {"date": "2023-Q2", "value": 26812.5},
      {"date": "2023-Q3", "value": 27063.0},
      {"date": "2023-Q4", "value": 27395.6}
    ]
  }
}

---

ListWorldBankIndicators

Retrieves development indicator data from the World Bank.

Endpoint: GET /api/economic/v1/list-world-bank-indicators

Request Parameters

indicator_code · string · required

World Bank indicator code (e.g., “NY.GDP.MKTP.CD”).

country_code · string

Optional country filter (ISO 3166-1 alpha-2).

year · integer

Optional year filter. Defaults to latest available.

page_size · integer

Maximum items per page.

cursor · string

Cursor for next page.

Response

data · array

Country-level indicator data.

Show WorldBankCountryData

country_code · string · required

ISO 3166-1 alpha-2 country code.

country_name · string

Country name.

indicator_code · string · required

World Bank indicator code.

indicator_name · string

Indicator name.

year · integer

Data year.

value · number

Indicator value.

pagination · object

Pagination metadata.

---

GetEnergyPrices

Retrieves current energy commodity prices from EIA.

Endpoint: GET /api/economic/v1/get-energy-prices

Request Parameters

commodities · array

Optional commodity filter. Empty returns all tracked commodities.

Response

prices · array

The list of energy prices.

Show EnergyPrice

commodity · string · required

Energy commodity identifier.

name · string

Human-readable name (e.g., “WTI Crude Oil”, “Henry Hub Natural Gas”).

price · number

Current price in USD.

unit · string

Unit of measurement (e.g., “$/barrel", "$/MMBtu”).

change · number

Percentage change from previous period.

price_at · integer

Price date, as Unix epoch milliseconds.

Example Response

{
  "prices": [
    {
      "commodity": "WTI",
      "name": "WTI Crude Oil",
      "price": 78.52,
      "unit": "$/barrel",
      "change": 2.3,
      "price_at": 1705334400000
    },
    {
      "commodity": "BRENT",
      "name": "Brent Crude Oil",
      "price": 83.18,
      "unit": "$/barrel",
      "change": 1.8,
      "price_at": 1705334400000
    },
    {
      "commodity": "NATGAS",
      "name": "Henry Hub Natural Gas",
      "price": 2.89,
      "unit": "$/MMBtu",
      "change": -3.2,
      "price_at": 1705334400000
    }
  ]
}

---

GetMacroSignals

Computes 7 macro signals from 6 upstream sources with BUY/CASH verdict.

Endpoint: GET /api/economic/v1/get-macro-signals

Request Parameters

No request parameters required.

Response

timestamp · string

ISO 8601 timestamp of computation.

verdict · string

Overall verdict: “BUY”, “CASH”, or “UNKNOWN”.

bullish_count · integer

Number of bullish signals.

total_count · integer

Total number of evaluated signals (excluding UNKNOWN).

signals · object

All 7 macro signals.

Show MacroSignals

liquidity · object

JPY-based liquidity squeeze detection.

flow_structure · object

BTC vs QQQ 5-day return comparison.

macro_regime · object

QQQ vs XLP 20-day rate of change regime.

technical_trend · object

BTC price vs moving averages and VWAP.

hash_rate · object

Bitcoin mining hash rate momentum.

mining_cost · object

Mining profitability estimate.

fear_greed · object

Crypto Fear & Greed index.

meta · object

Additional metadata (e.g., QQQ sparkline).

unavailable · boolean

True when upstream data is unavailable (fallback result).

---

GetEnergyCapacity

Retrieves installed capacity data (solar, wind, coal) from EIA.

Endpoint: GET /api/economic/v1/get-energy-capacity

Request Parameters

energy_sources · array

Energy source codes to query (e.g., “SUN”, “WND”, “COL”). Empty returns all tracked sources.

years · integer

Number of years of historical data. Default 20 if not set.

Response

series · array

Energy capacity time series.

Show EnergyCapacitySeries

energy_source · string

Energy source code.

name · string

Human-readable name.

data · array

Yearly capacity data points.

---

GetBisPolicyRates

Retrieves central bank policy rates from BIS.

Endpoint: GET /api/economic/v1/get-bis-policy-rates

Response

rates · array

The list of policy rates by country.

Show BisPolicyRate

country_code · string

ISO 2-letter country code (US, GB, JP, etc.)

country_name · string

Country or region name.

rate · number

Current policy rate percentage.

previous_rate · number

Previous period rate percentage.

date · string

Date as YYYY-MM.

central_bank · string

Central bank name (e.g. “Federal Reserve”).

---

GetBisExchangeRates

Retrieves effective exchange rates from BIS.

Endpoint: GET /api/economic/v1/get-bis-exchange-rates

Response

rates · array

The list of exchange rates by country.

Show BisExchangeRate

country_code · string

ISO 2-letter country code.

country_name · string

Country or region name.

real_eer · number

Real effective exchange rate index.

nominal_eer · number

Nominal effective exchange rate index.

real_change · number

Percentage change from previous period (real).

date · string

Date as YYYY-MM.

---

GetBisCredit

Retrieves credit-to-GDP ratio data from BIS.

Endpoint: GET /api/economic/v1/get-bis-credit

Response

entries · array

The list of credit-to-GDP entries by country.

Show BisCreditToGdp

country_code · string

ISO 2-letter country code.

country_name · string

Country or region name.

credit_gdp_ratio · number

Total credit as percentage of GDP.

previous_ratio · number

Previous quarter ratio.

date · string

Date as YYYY-QN.

---

Data Sources

FRED

Federal Reserve Economic Data - 800,000+ time series from authoritative sources

World Bank

Development indicators for 200+ countries and regions

EIA

U.S. Energy Information Administration - energy commodity prices and capacity data

BIS

Bank for International Settlements - central bank data and financial statistics