Name: exchange-rates
Price: 0.002 USDC
Availability: InStock

$ man exchange-rates

agentutility / edge-finance / exchange-rates

PRICE / CALL

$0.002

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgefinance

CATEGORY

uncategorized

STATUS

● live

NAME

exchange-rates — fx rates / forex / currency converter / usd to eur / ecb rates / historical exchange rates

SYNOPSIS

POST https://x402.org/v1/exchange-rates
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

FX rates / forex / currency converter / USD to EUR / ECB rates / historical exchange rates. Returns the latest or any historical day's exchange rates between currencies, sourced from the European Central Bank via the public Frankfurter API. Specify a base currency (default USD), an optional quote currency or list, an optional date (YYYY-MM-DD or 'latest'), and an optional amount to also receive a converted value when a single quote is supplied. No auth, commercial-OK.

INPUT — request schema

property	type	description	req?
base	string	ISO 4217 base currency code (e.g. 'USD', 'EUR'). Default 'USD'.	optional
quote	any	Single ISO 4217 quote currency, or array of codes. Omit for all available rates.	optional
date	string	'latest' (default) or a historical date in YYYY-MM-DD format.	optional
amount	number	Optional amount in the base currency. When a single quote is supplied, the response includes the converted amount.	optional

OUTPUT — response shape

field	type	description
base	string	Base currency code used for the returned rates (e.g. USD, EUR), echoing the request's base parameter.
date	string	Date of the rates in YYYY-MM-DD format; resolves to the latest ECB publication date when 'latest' was requested.
rates	string	Object mapping quote currency codes to their exchange rate against the base currency on the given date.
source	string	Upstream data provider label, identifying the European Central Bank via the Frankfurter API.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/exchange-rates \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the exchange-rates tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: edge-financeforexexchange-ratescurrency-converterfx-ratesecb-rateshistorical-ratesfrankfurter
methods: POST
cluster: edgefinance
price: $0.002 USDC per call

ADJACENT — other endpoints in edgefinance

endpoint	description	price
kalshi-markets	Kalshi markets / event contracts / Kalshi API / CFTC-regulated prediction markets / Kalshi browse / KalshiEX markets list.	$0.005
polymarket-leaderboard	Polymarket leaderboard / top traders / profit leaderboard / Polymarket whales / volume leaderboard / prediction market rankings.	$0.005
polymarket-markets	Polymarket markets / prediction market data / Polymarket API / list active prediction markets / crypto-settled betting odds / event odds…	$0.005
polymarket-trades	Polymarket trades / recent prediction market trades / on-chain bet history / Polymarket trade feed / Polymarket data API.	$0.005
insider-form-4	SEC Form 4 (insider transactions) normalizer.	$0.01
insider-trading	Insider trading feed.	$0.01
sec-filing	SEC EDGAR filing fetcher + parser + summarizer.	$0.01
bls-occupational-stats	BLS Public Data API — wages, employment levels, growth by series ID.	$0.02

/exchange-rates(1)