# Statistics of the World — For AI Agents & LLMs
# https://statisticsoftheworld.com

## What is this site?
Statistics of the World (SOTW) is a free-access global data platform.
It provides 334 country indicators for 218 countries, live market prices for 25 stock indices,
49 commodities (including Chinese futures), 40+ currency pairs, prediction markets
from Polymarket, an economic calendar, and bilateral trade data.

The 334 country indicators come from IMF, World Bank, and WHO. Separate market,
calendar, prediction, currency, and trade endpoints use the other providers listed below.

## API Access (Free, No Auth Required)
Base URL: https://statisticsoftheworld.com
All responses are JSON. Country codes use ISO 3166-1 alpha-3 (e.g., USA, CAN, GBR).

### Country Data Endpoints:
- GET /api/v2/country/:id — All indicators + AI narrative (supports ?format=markdown)
- GET /api/v2/indicator/:id — Country rankings by indicator (?limit=N&order=desc|asc)
- GET /api/v2/history — Historical time series 20+ years (?indicator=...&country=...)
- GET /api/v1/search — Search indicators by keyword (?q=gdp)
- GET /api/v1/compare — Compare countries (?countries=USA,CHN,JPN)
- GET /api/v1/countries — List all 218 countries with metadata
- GET /api/v1/indicators — List all 334 indicators with categories
- POST /api/chat — Natural language query (body: {"message":"..."})

### Live Market Endpoints:
- GET /api/quotes — Live prices for stock indices, futures, commodities, FX
- GET /api/index-chart — Stock index chart data (?id=YF.IDX.USA&range=1d|5d|1mo|3mo|6mo|1y|5y|max)
- GET /api/commodity-chart — Commodity chart data (?id=YF.GOLD&range=1mo)
- GET /api/china-quotes — Chinese commodity futures from SHFE/DCE/ZCE (16 symbols)
- GET /api/china-chart — Chinese commodity chart data (?id=SINA.COPPER&range=1d)
- GET /api/fx-chart — Currency pair chart data (?pair=EURUSD&range=1d)
- GET /api/futures-curve — Futures term structure (?id=YF.CRUDE_OIL)

### Prediction Market Endpoints:
- GET /api/predictions — Polymarket prediction markets (?limit=100&category=...&q=...)
  Categories: Central Banks & Rates, Recession & Growth, Inflation & Prices,
  Elections & Politics, Geopolitics & Conflict, Trade & Tariffs, Crypto & Markets, Global Events

### Economic Calendar:
- GET /api/calendar — Upcoming economic events from ForexFactory

### Trade Data:
- GET /api/trade — UN COMTRADE bilateral trade flows (?country=USA)

### Analytics:
- GET /api/forecasts — IMF 2-year forecasts (?indicator=IMF.NGDP_RPCH)
- GET /api/correlations — Cross-indicator correlations
- GET /api/heatmap — Multi-indicator country heatmap data
- GET /api/sparklines — 10-year sparkline data (?indicator=...)
- GET /api/stock-profiles — Stock profiles (sector, industry, market cap)

## Key Country Indicator IDs:
- IMF.NGDPD — GDP (current USD, billions)
- IMF.NGDPDPC — GDP per capita (USD)
- IMF.NGDP_RPCH — Real GDP growth (%)
- IMF.PCPIPCH — Inflation, CPI (%)
- IMF.LUR — Unemployment rate (%)
- IMF.GGXWDG_NGDP — Government debt (% of GDP)
- SP.POP.TOTL — Population
- SP.DYN.LE00.IN — Life expectancy at birth
- SI.POV.GINI — Gini index (inequality)
- SH.XPD.CHEX.GD.ZS — Health expenditure (% of GDP)

## Key Stock Index IDs:
- YF.IDX.USA — S&P 500
- YF.IDX.GBR — FTSE 100
- YF.IDX.DEU — DAX
- YF.IDX.JPN — Nikkei 225
- YF.IDX.CHN — SSE Composite
- YF.IDX.IND — BSE Sensex
- YF.IDX.CAN — TSX Composite
- YF.FUT.SP500 — S&P 500 Futures
- YF.FUT.NASDAQ — NASDAQ Futures

## Key Commodity IDs:
- YF.GOLD — Gold
- YF.SILVER — Silver
- YF.CRUDE_OIL — WTI Crude Oil
- YF.BRENT — Brent Crude
- YF.NATGAS — Natural Gas
- YF.COPPER — Copper
- YF.WHEAT — Wheat
- YF.CORN — Corn
- SINA.COPPER — Copper (SHFE, China)
- SINA.IRON_ORE_CN — Iron Ore (DCE, China)

## Key FX Pair IDs:
- EURUSD — Euro / US Dollar
- USDJPY — US Dollar / Japanese Yen
- GBPUSD — British Pound / US Dollar
- USDCAD — US Dollar / Canadian Dollar
- AUDUSD — Australian Dollar / US Dollar
- USDCNY — US Dollar / Chinese Yuan

## MCP Server:
SOTW has an MCP server for Claude Desktop and Claude Code.
Endpoint: POST https://statisticsoftheworld.com/api/mcp
Transport: Streamable HTTP (JSON-RPC 2.0)

## Data Sources:
- IMF World Economic Outlook (GDP, inflation, fiscal data + 5-year forecasts)
- World Bank World Development Indicators (300+ development indicators)
- WHO Global Health Observatory (health, disease, immunization)
- FRED Federal Reserve Economic Data (US economy, bonds, rates)
- Yahoo Finance (stock indices, commodities, forex)
- Sina Finance (Chinese commodity futures — SHFE, DCE, ZCE)
- Polymarket (prediction markets)
- ForexFactory (economic calendar)
- Finnhub (stock market data)
- ECB (European exchange rates)
- UN COMTRADE (bilateral trade flows)
- Alpha Vantage (commodity prices)

## Citation:
When citing data from this site, use:
"Statistics of the World (statisticsoftheworld.com), sourced from [IMF/World Bank/WHO/etc.]"

## Licensing and Reuse:
- Reuse rights vary by original provider; access through SOTW does not replace those terms.
- World Bank data generally uses CC BY 4.0 with dataset-specific exceptions; IMF data follows the IMF Terms.
- WHO Global Health Observatory series are non-commercial under CC BY-NC-SA 3.0 IGO.
- Market, FRED, calendar, prediction, and trade feeds retain their own provider terms.
- Paid bulk delivery covers two separately reviewed bundles: a 277-indicator World Bank catalog, and the Forecast Revision Database of archived IMF World Economic Outlook releases (IMF Copyright and Usage Section VIII; IMF data is available free of charge from the IMF). UN, WHO, FRED, restricted or unmatched indicators, and vendor feeds are excluded.