Index onlineMerchant portal
Api Endpoint

ECB FX Rates

Official daily foreign exchange reference rates from the European Central Bank (~30 currencies vs EUR, published each business day around 16:00 CET), rebased on request to any listed currency via EUR cross-rates and filtered to a requested symbol list; returns the reference date, the rate table and the ECB source attribution.

Open interactive test console

Offering

Provider
4yearcycle.com
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://4yearcycle.com/x402/fx-rates
MIME type
application/json
First seen
2026-10-16T01:50:06.715Z
Last seen
Tags
FX, forex, exchange-rates, currencies, ECB

Website

Payment pricing

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

Payment option 1
0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0x9862ca83b72aB95521F457aFf6e6EFb03d8164C3"
  }
]

Observed health

Status
Healthy
Latest latency
1201 ms
Average latency
1116 ms
HTTP status
402
Last checked
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 as ISO 4217 code (case-insensitive). EUR or any of the ~30 ECB-listed currencies (USD, GBP, JPY, CHF, ...); non-EUR bases are computed as cross-rates via EUR. Default: EUR.",
          "pattern": "^[A-Za-z]{3}$",
          "default": "EUR",
          "examples": [
            "EUR",
            "USD",
            "GBP"
          ]
        },
        "symbols": {
          "type": "string",
          "description": "Optional comma-separated ISO 4217 codes to restrict the rate table to (case-insensitive); codes the ECB does not list are ignored. Empty = all listed currencies.",
          "examples": [
            "USD,GBP,JPY",
            "CHF"
          ]
        }
      },
      "required": [],
      "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": {
              "default": "EUR",
              "description": "Base currency as ISO 4217 code (case-insensitive). EUR or any of the ~30 ECB-listed currencies (USD, GBP, JPY, CHF, ...); non-EUR bases are computed as cross-rates via EUR. Default: EUR.",
              "examples": [
                "EUR",
                "USD",
                "GBP"
              ],
              "pattern": "^[A-Za-z]{3}$",
              "type": "string"
            },
            "symbols": {
              "description": "Optional comma-separated ISO 4217 codes to restrict the rate table to (case-insensitive); codes the ECB does not list are ignored. Empty = all listed currencies.",
              "examples": [
                "USD,GBP,JPY",
                "CHF"
              ],
              "type": "string"
            }
          },
          "required": [],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "base": {
              "description": "Base currency of the rate table (ISO 4217)",
              "type": "string"
            },
            "date": {
              "description": "ECB reference date of the rates (YYYY-MM-DD, last business day)",
              "type": "string"
            },
            "notice": {
              "description": "ECB attribution notice: the underlying data is available free of charge from the ECB; cross-rates are computed values",
              "type": "string"
            },
            "rates": {
              "additionalProperties": {
                "type": "number"
              },
              "description": "Units of each quoted currency per 1 unit of base, e.g. rates.USD = USD per base. ECB publishes vs EUR; other bases are cross-rates via EUR rounded to 6 decimals.",
              "type": "object"
            },
            "source": {
              "description": "Always \"ECB\" — European Central Bank euro foreign exchange reference rates",
              "type": "string"
            }
          },
          "required": [
            "base",
            "date",
            "rates",
            "source",
            "notice"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}