# FXRate by YourAITools

> FXRate by YourAITools is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-26).

Convert an amount between 31 currencies at the official European Central Bank reference rate, for today or any date back to 1999

## Facts

- Endpoint: GET https://api.youraitools.co/fx/v1/convert?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fxrate-by-youraitools-32f52329
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YC3b_jaO4mZZSkC-I5DKJ

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 fxrate-by-youraitools-32f52329
```

Example prompt: Can you convert 250 US dollars to euros using today's ECB reference rate?

## When to prefer this

Choose this endpoint when you need official ECB reference rates (not bank or broker spreads), historical rates back to 1999, or a lightweight single-call currency conversion with no authentication setup beyond a micro-payment. Ideal for financial reporting, invoice reconciliation, and compliance use cases where ECB rates are the accepted standard. Prefer alternatives if you need real-time mid-market or live forex rates, rates for exotic currencies outside the 31 supported, or bulk batch conversions.

## Known failure modes

- Unsupported currency code returns an error — only 31 ISO 4217 codes are supported
- Weekend or holiday dates return the most recent prior ECB rate, which may surprise callers expecting a specific date
- Dates before 1999 are out of range and will fail
- Amount exceeding 1e15 is rejected
- Malformed date format (not YYYY-MM-DD) causes a bad request error
- Payment failure via x402 protocol returns 402 Payment Required

## How this service works

Currency converter API for AI agents. Convert an amount from one currency to another (USD, EUR, GBP, JPY, CNY, INR, CAD, AUD, CHF and 22 more) at the official European Central Bank reference rate, today or on a past date back to 1999. Returns rate, result, inverse rate and the rate date. Search intents: currency converter api, fx convert, exchange rate api, convert usd to eur, forex rate, money conversion for agents.

## Output

Returns a JSON object containing the source currency, target currency, the original amount, the ECB reference rate used, the converted result, the inverse rate, the ECB rate date, whether the rate was derived (cross-computed from EUR base), and a source attribution string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "To currency: ISO 4217 code, e.g. USD, EUR, GBP, JPY (31 supported)"
      },
      "date": {
       "type": "string",
       "description": "Optional YYYY-MM-DD (default: latest). Weekends/holidays use the previous ECB rate."
      },
      "from": {
       "type": "string",
       "description": "From currency: ISO 4217 code, e.g. USD, EUR, GBP, JPY (31 supported)"
      },
      "amount": {
       "type": "number",
       "description": "Amount to convert (default 1), up to 1e15"
      }
     },
     "description": "Search intents: currency converter api, fx convert, exchange rate api, convert usd to eur, forex rate, historical exchange rate"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "from",
      "to",
      "amount",
      "rate",
      "result",
      "date"
     ],
     "properties": {
      "to": {
       "type": "string"
      },
      "date": {
       "type": "string",
       "description": "ECB reference date used (YYYY-MM-DD)"
      },
      "from": {
       "type": "string"
      },
      "rate": {
       "type": "number"
      },
      "amount": {
       "type": "number"
      },
      "result": {
       "type": "number"
      },
      "source": {
       "type": "string"
      },
      "derived": {
       "type": "boolean",
       "description": "true unless the base is EUR: the rate is computed (inverse or cross) from the ECB euro reference rates"
      },
      "inverse_rate": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "EUR",
  "date": "2026-10-23",
  "from": "USD",
  "rate": 0.89342,
  "amount": 100,
  "result": 89.342,
  "source": "Source: ECB statistics (euro foreign exchange reference rates), via the open-source Frankfurter API.",
  "derived": true,
  "inverse_rate": 1.119294
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fxrate-by-youraitools-32f52329/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)