Api Endpoint

Official Macro & FX Data

Use when an agent needs an official exchange rate to convert prices, invoices or portfolios: ECB euro reference rates for ~30 currencies (USD, GBP, CHF, JPY, CNY …), latest or for any day since 1999, with any base currency (cross rates computed from the ECB fix). Returns the exact rate date. Source named in every answer. Bad input: HTTP 400 before payment; unknown currency or outage is not charged.

Open interactive test console

Offering

Provider: x402-apis.pages.dev
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Financial Analysis
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://x402-apis.pages.dev/v1/fx-rates
MIME type: application/json
First seen: 2026-10-16T01:50:24.663Z
Last seen: 2026-11-02T19:46:22.528Z
Tags: FX, exchange-rates, Currency, ECB, EUR, USD, historical

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0x896baBcda513322AF2218fe7346353846835f978"
  }
]

Observed health

Status: Healthy
Latest latency: 425 ms
Average latency: 415 ms
HTTP status: 402
Last checked: 2026-11-02T19:46:22.518Z
Reachability: 100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "base": {
          "type": "string",
          "description": "Base currency, 3 letters, default EUR. Any ECB reference currency."
        },
        "symbols": {
          "type": "string",
          "description": "Comma-separated target currencies, e.g. USD,CHF,GBP. Default: all."
        },
        "date": {
          "type": "string",
          "description": "Day as YYYY-MM-DD (1999-01-04 or later). Default: latest. Weekends/holidays return the previous ECB fix."
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "base": {
              "description": "Base currency, 3 letters, default EUR. Any ECB reference currency.",
              "type": "string"
            },
            "date": {
              "description": "Day as YYYY-MM-DD (1999-01-04 or later). Default: latest. Weekends/holidays return the previous ECB fix.",
              "type": "string"
            },
            "symbols": {
              "description": "Comma-separated target currencies, e.g. USD,CHF,GBP. Default: all.",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "base": {
              "type": "string"
            },
            "date": {
              "type": "string"
            },
            "rates": {
              "type": "object"
            },
            "source": {
              "type": "string"
            }
          },
          "required": [
            "base",
            "date",
            "rates",
            "source"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}