# Currency Exchange Rates

> Currency Exchange Rates is a paid API for AI agents from data.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns the exchange rate (and optionally converted amount) between two currencies for a given date, paid per-call via x402 USDC.

## Facts

- Endpoint: POST https://data.tollkit.dev/fx?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/currency-exchange-rates-95bd7f7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_y48RzaqS9bh-SP4m9M5aq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability currency-exchange-rates-95bd7f7e -d '<json body>'
```

Example prompt: What's the exchange rate from USD to EUR for 2025-04-10, and how much would 250 USD be in euros?

## When to prefer this

Choose this endpoint when you need a quick, accountless, pay-per-use FX rate lookup for a specific currency pair and recent date (within 90 days), especially in contexts where setting up a traditional API subscription is impractical. Ideal for agents doing one-off or occasional currency conversions without requiring registration or an API key.

## Known failure modes

- Invalid 3-letter currency code returns an error
- Date outside the 90-day lookback window is rejected
- Weekend date without a prior business day rate may fail or auto-resolve
- Payment failure via x402 if insufficient USDC balance
- Malformed date format (not YYYY-MM-DD) causes a validation error
- Unsupported or exotic currency pair may return no data

## How this service works

SEC filings and financials, IP lookup, US weather, airport delays, address geocoding and exchange rates. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://chain.tollkit.dev/openapi.json.

## Output

Returns the exchange rate between the specified currency pair for the requested date, along with the converted amount if an input amount was provided. Weekend dates resolve to the previous business day's rate.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "pattern": "^[A-Za-z]{3}$"
  },
  "date": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "YYYY-MM-DD within the last 90 days; weekends use the previous business day."
  },
  "from": {
   "type": "string",
   "pattern": "^[A-Za-z]{3}$"
  },
  "amount": {
   "type": "number",
   "default": 1,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "EUR",
  "from": "USD",
  "rate": 0.8908686,
  "amount": 100,
  "notice": "These reference rates are published free of charge by the European Central Bank at https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html. They are for information purposes only, not for transactions.",
  "source": "European Central Bank euro foreign exchange reference rates",
  "converted": 89.08685969,
  "rate_date": "2026-10-02",
  "requested_date": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/currency-exchange-rates-95bd7f7e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.tollkit.dev](https://www.zero.xyz/host/data.tollkit.dev/llms.txt)