Back to FX Reference Rates API
Card snapshot
fx-reference-rates.regnotes.workers.dev
·
2026-11-01 14:14:54 UTC
·
6c90b00db18bfe060e54f26382e14adf371d5539e79e1d2db5cc7cb85b45e4d0
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"protocolVersion": "0.3.0",
"name": "FX Reference Rates API",
"description": "Daily ECB euro foreign exchange reference rates for 30 currencies (incl. EUR), any base via cross rates, conversion, historical dates (2024-09-30 onward) and time series. Updated daily. Source: ECB (European Central Bank euro foreign exchange reference rates). Reference rates are published around 16:00 CET on TARGET business days for information purposes only; not for transaction pricing. Cross rates are derived via EUR. Also: AI infrastructure price reference data (cloud GPU instance list prices on AWS and Azure, LLM API token prices), refreshed daily. Also: country macroeconomic indicators (GDP, growth, inflation, unemployment, debt, current account, reserves, FDI, population and more) for ~217 economies from the World Bank World Development Indicators (CC BY 4.0). Pay per call with USDC via x402 (or MPP on Tempo). No account, no API key.",
"url": "https://fx-reference-rates.regnotes.workers.dev",
"preferredTransport": "HTTP+JSON",
"version": "1.0.0",
"provider": {
"organization": "apac-regnotes",
"url": "https://fx-reference-rates.regnotes.workers.dev"
},
"documentationUrl": "https://fx-reference-rates.regnotes.workers.dev/openapi.json",
"capabilities": {
"streaming": false,
"pushNotifications": false,
"extensions": [
{
"uri": "https://x402.org",
"description": "x402 v2 pay-per-call: GET a paid path, receive HTTP 402 with a PAYMENT-REQUIRED header, retry with PAYMENT-SIGNATURE (EIP-3009, exact scheme). Facilitator settles; buyer pays no gas.",
"required": true,
"params": {
"x402Version": 2,
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"currency": "USDC",
"payTo": "0xF98B4FDAC9c2AcCD59803316a2b2DFf2E653F5Ad"
}
},
{
"uri": "https://mpp.dev",
"description": "MPP alternative on the same 402: WWW-Authenticate: Payment challenge, pull-mode credentials only.",
"required": false,
"params": {
"method": "tempo",
"intent": "charge",
"chainId": 4217,
"currency": "0x20C000000000000000000000b9537d11c60E8b50",
"label": "USDC.e on Tempo (chain 4217)",
"payTo": "0xF98B4FDAC9c2AcCD59803316a2b2DFf2E653F5Ad"
}
}
]
},
"defaultInputModes": [
"application/json"
],
"defaultOutputModes": [
"application/json"
],
"securitySchemes": {
"x402": {
"type": "http",
"scheme": "x402",
"description": "HTTP 402 + PAYMENT-SIGNATURE header (x402 v2, exact scheme, USDC eip155:8453)"
}
},
"skills": [
{
"id": "v1-rates-latest",
"name": "Latest reference rates in any base",
"description": "Today's exchange rates (forex reference rates, most recent ECB publication) for ~30 currencies in any base currency, e.g. USD to JPY, CNY, EUR, GBP, HKD, SGD, KRW, INR. Filter with symbols. Returns as_of date and source attribution. Price: $0.001 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.001 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/rates/latest?base=USD&symbols=JPY%2CCNY%2CEUR"
]
},
{
"id": "v1-convert",
"name": "Convert an amount between currencies",
"description": "Currency converter: convert an amount between any two of ~30 currencies (e.g. 100 USD to JPY) at the latest ECB reference rate or as of a past date. Returns rate, result and as_of date. Price: $0.001 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.001 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/convert?from=USD&to=JPY&amount=100"
]
},
{
"id": "v1-rates-historical",
"name": "Reference rates on a date",
"description": "ECB reference rates on a given date in any base; non-publication days fall back to the previous publication day (as_of). Price: $0.002 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.002 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/rates/historical?date=2026-06-30&base=EUR&symbols=USD%2CGBP"
]
},
{
"id": "v1-rates-timeseries",
"name": "Daily time series for a currency pair",
"description": "Daily reference rate series for base/symbol between start and end (max 366 days), with min/max/mean and change. Price: $0.003 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.003 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/rates/timeseries?base=USD&symbol=JPY&start=2026-09-01&end=2026-09-30"
]
},
{
"id": "v1-dataset-csv",
"name": "Rate history as CSV, paged (newest first)",
"description": "Bulk download, paged: publication days as CSV (date + one column per currency) in the requested base (default EUR), newest first. Default page = latest 60 days (~14 KB); page with offset and limit (1-1000 rows); optional start/end (YYYY-MM-DD) window. Total rows and next offset are in the X-Total-Rows / X-Next-Offset headers and a trailing comment line. Price: $0.01 USDC per page (up to 1000 rows) (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.01 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/dataset/csv?base=EUR&limit=60"
],
"outputModes": [
"text/csv"
]
},
{
"id": "v1-ai-gpu-prices",
"name": "Cloud GPU instance prices, cheapest first",
"description": "Cloud GPU price comparison: hourly list prices of GPU / AI accelerator instances (H100, H200, A100, L40S, L4, A10G, T4, B200, MI300X, Trainium, Inferentia ...) on AWS and Azure in US, EU and Asia regions, on-demand and Azure Spot, ranked by USD per GPU-hour. Filter by gpu model, cloud, region, pricing. Official provider price APIs, refreshed daily. Price: $0.005 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.005 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/ai/gpu-prices?gpu=H100&pricing=on_demand&limit=5"
]
},
{
"id": "v1-ai-llm-prices",
"name": "LLM API token prices by model",
"description": "LLM API pricing lookup: USD per 1M input, output and cached-input tokens plus context window for ~3,300 models (OpenAI GPT, Anthropic Claude, Google Gemini, DeepSeek, Llama, Mistral, Qwen, xAI ...) across providers (direct, Azure, Bedrock, Vertex, Together, Fireworks ...). Filter by model and provider; sorted by input price. Price: $0.005 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.005 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/ai/llm-prices?model=claude-sonnet-4-5"
]
},
{
"id": "v1-ai-dataset",
"name": "AI price dataset (GPU or LLM rows) as JSON, paged",
"description": "Bulk download, paged: cloud GPU instance price rows (AWS + Azure, 10 regions, on-demand and spot, GPU model/count, $/GPU-hour) or LLM API token price rows (~3,500 models) with per-source retrieval timestamps. section=gpu (default) or llm; default page = 80 rows (~22 KB); page with offset and limit (1-1000). Response carries total, next_offset and a ready-made next URL. Price: $0.02 USDC per page (up to 1000 rows) (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.02 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/ai/dataset?section=gpu&limit=80"
]
},
{
"id": "v1-macro-country",
"name": "Country macro snapshot: all indicators, latest + history",
"description": "Country economic profile: latest value and year plus annual history (2005 onward) for 21 World Bank World Development Indicators: GDP (USD), real GDP growth, GDP per capita, GNI per capita PPP, CPI inflation, unemployment, population, exports/imports % GDP, current account % GDP, central government debt % GDP, tax revenue % GDP, real and lending interest rates, FDI inflows % GDP, total reserves, official exchange rate, remittances % GDP, Gini, life expectancy, internet users. Country by ISO3/ISO2 code or name. CC BY 4.0. Price: $0.02 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.02 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/macro/country?country=JPN&years=5"
]
},
{
"id": "v1-macro-indicator",
"name": "One indicator across countries and years",
"description": "Macroeconomic time series: one World Development Indicator (e.g. inflation_cpi_pct, gdp_growth_pct, central_govt_debt_pct_gdp) for up to 20 countries over a year range, annual values. See free /macro/indicators for keys. CC BY 4.0. Price: $0.01 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.01 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/macro/indicator?indicator=inflation_cpi_pct&countries=USA%2CJPN%2CDEU&start=2020"
]
},
{
"id": "v1-macro-rank",
"name": "Rank countries by an indicator",
"description": "Country ranking: sort all economies by one World Development Indicator for a year (default: each country's latest value), highest first or lowest first, optionally filtered by World Bank region or income group. Aggregates (World, regions) excluded unless requested. CC BY 4.0. Price: $0.02 USDC per request (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.02 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/macro/rank?indicator=gdp_growth_pct®ion=Europe&limit=10"
]
},
{
"id": "v1-macro-dataset",
"name": "World Bank WDI dataset, paged by indicator",
"description": "Bulk download, paged: annual values (2005 onward) for one World Development Indicator per page across all ~296 economies and aggregates, with indicator metadata and country names/regions/income groups. indicator=<key> (default first key; list at free /macro/indicators); default page = 50 countries (~25 KB); page with offset and limit (1-300). next points to the next country page, then to the next indicator. CC BY 4.0. Price: $0.02 USDC per page (one indicator, up to 300 countries) (fixed; one paid HTTP GET = one charge; x402 exact on Base or MPP on Tempo; 4xx errors are not charged). Price: $0.02 USDC per call (x402 or MPP).",
"tags": [
"fx",
"forex",
"exchange-rates",
"currency",
"currency-converter",
"conversion",
"finance",
"ecb",
"usd",
"eur",
"jpy",
"cny",
"gpu-pricing",
"llm-pricing",
"cloud-pricing",
"ai",
"macroeconomics",
"world-bank",
"gdp",
"inflation",
"country-data",
"economic-indicators"
],
"examples": [
"https://fx-reference-rates.regnotes.workers.dev/v1/macro/dataset?indicator=gdp_growth_pct&limit=50"
]
}
]
}