2s-rjsw718bb-alleyford.vercel.app · timeseries

Historical daily exchange-rate series from the European Central Bank (via Frankfurter), with computed summary statistics. Pass base = 3-letter ISO 4217 currency (default USD), start = YYYY-MM-DD, optional end = YYYY-MM-DD (default = latest available), optional symbols = comma-separated target codes (default all), optional amount to scale rates (default 1). Range is capped at 366 days. Returns, per target currency, first/last/min/max/mean rate plus absolute and percentage change over the window, alongside the full daily series. ECB publishes on business days only; weekends and holidays are omitted.

Call it in 30 seconds

// This service settles on Base Sepolia.
// Use an x402 client with a matching signer (e.g. an @x402 Solana client).
// First, inspect the payment terms for free:
const r = await fetch("https://2s-rjsw718bb-alleyford.vercel.app/api/fx/timeseries"); // returns HTTP 402 + machine-readable terms
console.log(r.status, await r.json());

# This service settles on Base Sepolia.
# Use an x402 client with a matching signer. To see the terms first, for free:
import httpx
r = httpx.get("https://2s-rjsw718bb-alleyford.vercel.app/api/fx/timeseries")  # HTTP 402 + machine-readable payment terms
print(r.status_code, r.json())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://2s-rjsw718bb-alleyford.vercel.app/api/fx/timeseries?base=USD&end=2025-03-31&start=2025-01-01&symbols=EUR,GBP"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →