Economic Service

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.

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

Overview

Services

Data Sources

Overview

GetFredSeries

Request Parameters

Response

Example Request

Example Response

ListWorldBankIndicators

Request Parameters

Response

GetEnergyPrices

Request Parameters

Response

Example Response

GetMacroSignals

Request Parameters

Response

GetEnergyCapacity

Request Parameters

Response

GetBisPolicyRates

Response

GetBisExchangeRates

Response

GetBisCredit

Response

Data Sources

FRED

World Bank

EIA

BIS

Build docs developers (and LLMs) love

Overview

Services

Data Sources

​Overview

​GetFredSeries

​Request Parameters

​Response

​Example Request

​Example Response

​ListWorldBankIndicators

​Request Parameters

​Response

​GetEnergyPrices

​Request Parameters

​Response

​Example Response

​GetMacroSignals

​Request Parameters

​Response

​GetEnergyCapacity

​Request Parameters

​Response

​GetBisPolicyRates

​Response

​GetBisExchangeRates

​Response

​GetBisCredit

​Response

​Data Sources

FRED

World Bank

EIA

BIS

Build docs developers (and LLMs) love

Overview

GetFredSeries

Request Parameters

Response

Example Request

Example Response

ListWorldBankIndicators

Request Parameters

Response

GetEnergyPrices

Request Parameters

Response

Example Response

GetMacroSignals

Request Parameters

Response

GetEnergyCapacity

Request Parameters

Response

GetBisPolicyRates

Response

GetBisExchangeRates

Response

GetBisCredit

Response

Data Sources