# GET /eu/fx: $0.002 per call

Official ECB euro foreign-exchange reference rates for about 30 currencies, converted to any base (GBP, USD, EUR...). Latest or any past date since 1999 (the last rate published on or before it). Optional amount conversion.

- **Price:** $0.002 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Tier:** cached
- **Answers cached for:** 1 hour(s)
- **Data sources:** European Central Bank reference rates (free)
- **Lane:** UK & EU open data ([OpenAPI](/openapi/uk-data.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/eu-fx](/sample/eu-fx). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/eu-fx"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/eu/fx?base=GBP&symbols=USD%2CEUR%2CJPY"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/eu/fx?base=GBP&symbols=USD%2CEUR%2CJPY");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("eu-fx", {"base":"GBP","symbols":"USD,EUR,JPY"});
```

## Inputs

- `base` (string): Base currency, default EUR.
- `symbols` (string): Comma-separated currencies to return (default: all).
- `amount` (number): Amount of the base currency to convert (default 1).
- `date` (string): YYYY-MM-DD; default latest.

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "base": "GBP",
  "amount": 1,
  "date": "2026-09-25",
  "rates": {
    "USD": 1.3253,
    "EUR": 1.1622,
    "JPY": 197.41
  },
  "source": "European Central Bank euro reference rates (published around 16:00 CET on TARGET working days)"
}
```

## Related

- [GET /uk/postcode](/services/uk-postcode) ($0.003): UK postcode lookup: coordinates, country, region, local authority, ward, parish, parliamentary constituency, LSOA/MSOA and official ONS codes.
- [GET /uk/area](/services/uk-area) ($0.01): UK area profile for a postcode or postcode district (e.g.
- [GET /uk/food-hygiene](/services/uk-food-hygiene) ($0.005): UK food hygiene ratings (Food Standards Agency) for restaurants, takeaways, shops and other food businesses: rating (0-5 or Pass/Improvement Required in Scotlan
- [GET /uk/house-prices](/services/uk-house-prices) ($0.01): Sold house prices for any England or Wales postcode from HM Land Registry Price Paid data (1995 to date): each sale's price, date, address, property type (detac
- [GET /uk/company](/services/uk-company) ($0.005): UK company check from Companies House: search by ?q=name, or pass ?number=00445790 for the full profile: status, type, incorporation date, registered office, SI
- [GET /uk/bank-holidays](/services/uk-bank-holidays) ($0.001): Official UK bank holidays (England & Wales, Scotland, Northern Ireland) from GOV.UK.
- [GET /eu/vat](/services/eu-vat) ($0.005): Check an EU VAT number live against the European Commission's VIES system: valid or not, and the registered company name and address where the member state shar
- [GET /eu/lei](/services/eu-lei) ($0.005): Look up legal entities in the global LEI register (GLEIF, 2.9M+ companies and funds worldwide): by LEI (with direct and ultimate parent companies), by name, or 

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).