Skip to content
Back to FX Reference Rates API

Card snapshot

fx-reference-rates.regnotes.workers.dev · 2026-11-04 13:59:49 UTC · 606879cb4a993245ba378d9d2e65adcbedc4e61f61bb87cdd00d6d95367b0ccf

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-10-07 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&region=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"
      ]
    }
  ]
}