# orbit Econ Data

> Economic and country data for agents: European Central Bank FX reference rates, currency conversion and rate history (via Frankfurter), country reference facts for 250 countries, and the latest World Bank macro indicators (GDP, growth, inflation, population, unemployment…). Open data with attribution, fetched at call time. $0.001 per call. Pay per call with x402 (USDC on Base, no account, no API key). Free MCP (trimmed sample output) at https://orbit-econ.orbit-builder.workers.dev/mcp. By orbit-builder.

## Paid endpoints (x402 v2, exact, eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, payTo 0x9Da4B249B8afa7818de5BFf7eEd8b13e6feeb9b3). Bad input is rejected with 400 before payment; upstream errors return >=400 and are never settled. A call with no parameters runs the example input shown.

- Exchange rates (ECB) ($0.001): GET or POST https://orbit-econ.orbit-builder.workers.dev/v1/fx — Latest (or historical, by date) foreign-exchange reference rates published by the European Central Bank for ~30 major currencies (USD, EUR, GBP, JPY, CNY, CHF, CAD, AUD, INR, BRL, KRW, MXN, PLN, TRY, ZAR…), against any base currency in the set. Returns base, rate date, and rates map. Not for crypto.
  params: base (ISO 4217 base (default USD)); symbols (comma-separated targets (default all)); date (optional YYYY-MM-DD (from 1999-01-04))
  example: https://orbit-econ.orbit-builder.workers.dev/v1/fx?base=USD&symbols=EUR%2CGBP%2CJPY%2CCNY
- Currency conversion (ECB) ($0.001): GET or POST https://orbit-econ.orbit-builder.workers.dev/v1/convert — Convert an amount between currencies at the latest (or a historical date's) European Central Bank reference rate: amount, from, one or more targets → converted amounts, rate used, inverse rate and rate date. ~30 fiat currencies; no crypto.
  params: amount (amount to convert (default 1)); from* (ISO 4217 source currency); to* (comma-separated target currencies); date (optional YYYY-MM-DD)
  example: https://orbit-econ.orbit-builder.workers.dev/v1/convert?amount=250&from=EUR&to=USD%2CGBP%2CJPY
- Exchange-rate history (ECB) ($0.001): GET or POST https://orbit-econ.orbit-builder.workers.dev/v1/fx-history — Daily ECB reference-rate time series for one currency pair over a date range (up to 1 year; default last 30 days): every business-day rate plus first, last, min, max, mean, and % change. ~30 fiat currencies; weekends/holidays have no fixing.
  params: base (ISO 4217 base (default USD)); symbol* (target currency); start (YYYY-MM-DD (default 30 days ago)); end (YYYY-MM-DD (default today))
  example: https://orbit-econ.orbit-builder.workers.dev/v1/fx-history?base=USD&symbol=EUR
- Country facts ($0.001): GET or POST https://orbit-econ.orbit-builder.workers.dev/v1/country — Reference facts for any of 250 countries/territories by ISO code or English name: common + official name, ISO alpha-2/alpha-3/numeric, capital, region/subregion, languages, currencies (code, name, symbol), calling codes, internet TLD, lat/lng, area km², bordering countries, landlocked, UN member, flag emoji, plus World Bank region and income level.
  params: country* (ISO alpha-2/alpha-3 code or English name, e.g. KZ, DEU, Japan)
  example: https://orbit-econ.orbit-builder.workers.dev/v1/country?country=Kazakhstan
- Country economic indicators (World Bank) ($0.001): GET or POST https://orbit-econ.orbit-builder.workers.dev/v1/indicators — Latest available World Bank values for a country, each with its year: GDP (current US$), real GDP growth %, GDP per capita US$, CPI inflation %, population, unemployment %, life expectancy, internet users %, exports % of GDP, central government debt % of GDP. Missing series are null. CC BY 4.0.
  params: country* (ISO alpha-2/alpha-3 code or English name)
  example: https://orbit-econ.orbit-builder.workers.dev/v1/indicators?country=DE

Bad input returns 400 before payment; not-found and upstream errors return 4xx/5xx and are never settled.

## Free

- https://orbit-econ.orbit-builder.workers.dev/v1/preview?tool=<name> (runs the fixed example input live)
- MCP (streamable HTTP, JSON-RPC 2.0 POST): https://orbit-econ.orbit-builder.workers.dev/mcp — tools: fx_rates, fx_convert, fx_history, country_info, country_indicators
- https://orbit-econ.orbit-builder.workers.dev/openapi.json, https://orbit-econ.orbit-builder.workers.dev/.well-known/x402, https://orbit-econ.orbit-builder.workers.dev/.well-known/agent.json

## Data sources
- fx_rates: European Central Bank reference rates via Frankfurter (api.frankfurter.dev); ECB publishes ~16:00 CET on TARGET working days
- fx_convert: European Central Bank reference rates via Frankfurter (api.frankfurter.dev); ECB publishes ~16:00 CET on TARGET working days
- fx_history: European Central Bank reference rates via Frankfurter (api.frankfurter.dev); ECB publishes ~16:00 CET on TARGET working days
- country_info: mledoze/countries dataset (ODbL 1.0) + World Bank country API
- country_indicators: World Bank Open Data API (api.worldbank.org), CC BY 4.0