Current FX Reference Rates

Fetch current reference foreign-exchange rates for a base currency, optionally filtered to target currencies.

0.02 USDC / request GET live_source Base mainnet x402 v2

Preview request

The preview path is rate-limited and does not charge. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.

curl --request GET \
  "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/fx_rates?preview=true&base=EUR&target=USD"

Input contract

ParameterTypeRequiredDescription
basestringYesBase currency code (e.g., EUR).
targetstringYesTarget currency code (e.g., USD).

Guaranteed response metadata

Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract and can be inspected through the preview request where available.

{
  "marketplace_metadata": {
    "data_mode": "live_source",
    "billable": true,
    "availability": "operational",
    "source": "ExchangeRate-API open endpoint"
  }
}

Agent payment flow

Request the product, read the base64 PAYMENT-REQUIRED challenge, sign the exact Base-USDC authorization with an x402 buyer client, and retry using PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.