---
title: ECB Currency Converter API
slug: ecb-currency-converter
url: https://apyhub.com/callable-labs/service/ecb-currency-converter
provider: Callable Labs
tags: [currency-conversion, exchange-rate, foreign-exchange, currency-list]
auth: api_key
version: 0.1.0
service_type: sync
endpoints: 2
atoms: 3
mcp: true
---

# ECB Currency Converter API

Convert currencies easily with the latest or historical exchange rates. Calculate converted amounts and retrieve exchange rate details for payments, invoicing, and financial applications.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/callable-labs/ecb-currency-converter/v1/currencies` | What it does Returns the list of currencies available from the currency conversion service, along w… | 3 |
| GET | `https://api.eu.apyhub.com/callable-labs/ecb-currency-converter/v1/convert` | What it does Converts an amount from one currency to another using the query parameters from, to, a… | 3 |

## Endpoint reference

### List currencies

`GET https://api.eu.apyhub.com/callable-labs/ecb-currency-converter/v1/currencies` · 3 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

Fetch the latest list of currencies supported by the API.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/ecb-currency-converter/v1/currencies" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `count` as an integer, `latest` as a date string, and `currencies` as an array of currency objects.

Each currency object includes `code`, `name`, `kind`, `first_date`, `last_date`, and `current`, with optional `parity` when applicable.

```json
{
  "count": 66,
  "latest": "2026-10-06",
  "currencies": [
    {
      "code": "AED",
      "name": "UAE dirham",
      "kind": "peg",
      "first_date": "1999-01-04",
      "last_date": "2026-10-06",
      "current": true,
      "parity": "3.6725 per USD (fixed)"
    }
  ]
}
```

### Convert currency

`GET https://api.eu.apyhub.com/callable-labs/ecb-currency-converter/v1/convert` · 3 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `to` | query | string | yes | ISO 4217 code |
| `date` | query | string (date) | no | Use that day's rates; default latest |
| `from` | query | string | yes | ISO 4217 code |
| `amount` | query | number | no | Amount in `from` Default: `1`. |

#### Quickstart

Convert 100 USD to EUR using the current exchange rate.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/ecb-currency-converter/v1/convert?from=USD&to=EUR&amount=100" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `source`, `notice`, `pegged`, `from`, `to`, `amount`, `rate`, `result`, and `date` fields, and may also include `requested_date`. `source` and `notice` are strings, `pegged` is an array of currency codes, `rate` and `result` are numbers, and the remaining fields describe the conversion details.

```json
{
  "source": "European Central Bank euro foreign exchange reference rates; fixed-parity currencies derived from their official pegs",
  "notice": "Reference rates for information, published around 16:00 CET on TARGET business days; not for trading.",
  "pegged": [],
  "from": "USD",
  "to": "EUR",
  "amount": 100,
  "rate": 0.88738131,
  "result": 88.738131,
  "date": "2026-10-06",
  "requested_date": null
}
```

## About

## What it does
ECB Currency Converter API turns an amount in one currency into another, using the same European Central Bank (ECB) reference rates and fixed-parity data as the rest of this API. It converts between any of the currencies this API tracks, using either the latest published rate or a specific past day's rate.

You send the currency you're converting from, the currency you're converting to, and an amount (1 if you leave it out). The response gives back the converted amount, the rate that was used, and the date that rate was published. If you ask for a specific past day and that day had no publication (a weekend or TARGET holiday), the conversion automatically falls back to the last published day before it and tells you the date you originally asked for. The response also tells you if either currency involved is pegged, meaning its rate comes from a fixed official parity instead of an ECB rate, along with a source note and a usage notice. You can also look up the full list of tracked currencies to check which ones are currently active, retired, or pegged before converting between them.

ECB Currency Converter API is a good fit for checkout flows, invoicing, expense tools, and any application that needs to show a price or amount in a different currency without building its own FX logic.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/callable-labs/service/ecb-currency-converter