Documentation

Endpoint reference

All six endpoints across both markets, their parameters and responses.

Fiat

fiat

GET/v1/rates

Exchange rates

Every quoted currency against one base. The response carries the quote date and the timestamp the rates were captured.

Parameter	Required	Description
base	no	ISO 4217 base currency. Defaults to USD.

curl "https://api.currencyrates-api.com/v1/rates?base=USD" \
  -H "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"

const response = await fetch("https://api.currencyrates-api.com/v1/rates?base=USD", {
  headers: { Authorization: "Bearer fx_live_xxxxxxxxxxxxxxxxxx" },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.currencyrates-api.com/v1/rates?base=USD",
    headers={"Authorization": "Bearer fx_live_xxxxxxxxxxxxxxxxxx"},
    timeout=10,
)
data = response.json()

<?php

$context = stream_context_create([
    "http" => ["header" => "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"],
]);

$data = json_decode(file_get_contents("https://api.currencyrates-api.com/v1/rates?base=USD", false, $context), true);

200 OK

{
  "base": "USD",
  "date": "2026-08-13",
  "updated_at": "2026-08-13T18:40:02Z",
  "rates": {
    "BRL": 5.4123,
    "EUR": 0.9187,
    "GBP": 0.7842,
    "JPY": 147.2,
    "MXN": 18.6431
  }
}

GET/v1/convert

Convert an amount

Converts between two currencies and returns both the applied rate and the result, so you can persist the rate you charged.

Parameter	Required	Description
from	yes	Source currency code.
to	yes	Target currency code.
amount	no	Amount in the source currency. Defaults to 1.

curl "https://api.currencyrates-api.com/v1/convert?from=USD&to=BRL&amount=100" \
  -H "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"

const response = await fetch("https://api.currencyrates-api.com/v1/convert?from=USD&to=BRL&amount=100", {
  headers: { Authorization: "Bearer fx_live_xxxxxxxxxxxxxxxxxx" },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.currencyrates-api.com/v1/convert?from=USD&to=BRL&amount=100",
    headers={"Authorization": "Bearer fx_live_xxxxxxxxxxxxxxxxxx"},
    timeout=10,
)
data = response.json()

<?php

$context = stream_context_create([
    "http" => ["header" => "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"],
]);

$data = json_decode(file_get_contents("https://api.currencyrates-api.com/v1/convert?from=USD&to=BRL&amount=100", false, $context), true);

200 OK

{
  "from": "USD",
  "to": "BRL",
  "amount": 100,
  "rate": 5.4123,
  "result": 541.23,
  "date": "2026-08-13",
  "updated_at": "2026-08-13T18:40:02Z"
}

GET/v1/currencies

Currency metadata

Names and symbols for every quoted fiat currency, translated when a locale is supplied.

Parameter	Required	Description
locale	no	Language for currency names. Defaults to English.

curl "https://api.currencyrates-api.com/v1/currencies" \
  -H "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"

const response = await fetch("https://api.currencyrates-api.com/v1/currencies", {
  headers: { Authorization: "Bearer fx_live_xxxxxxxxxxxxxxxxxx" },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.currencyrates-api.com/v1/currencies",
    headers={"Authorization": "Bearer fx_live_xxxxxxxxxxxxxxxxxx"},
    timeout=10,
)
data = response.json()

<?php

$context = stream_context_create([
    "http" => ["header" => "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"],
]);

$data = json_decode(file_get_contents("https://api.currencyrates-api.com/v1/currencies", false, $context), true);

200 OK

{
  "locale": "en",
  "date": "2026-08-13",
  "updated_at": "2026-08-13T18:40:02Z",
  "currencies": {
    "USD": { "name": "US Dollar", "symbol": "$" },
    "BRL": { "name": "Brazilian Real", "symbol": "R$" },
    "EUR": { "name": "Euro", "symbol": "€" }
  }
}

Crypto

crypto

GET/v1/crypto/rates

Cryptocurrency rates

Digital assets quoted against a fiat or crypto base, on the same response shape as the fiat endpoint.

Parameter	Required	Description
base	no	Base currency for the quotes. Defaults to USD.

curl "https://api.currencyrates-api.com/v1/crypto/rates?base=USD" \
  -H "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"

const response = await fetch("https://api.currencyrates-api.com/v1/crypto/rates?base=USD", {
  headers: { Authorization: "Bearer fx_live_xxxxxxxxxxxxxxxxxx" },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.currencyrates-api.com/v1/crypto/rates?base=USD",
    headers={"Authorization": "Bearer fx_live_xxxxxxxxxxxxxxxxxx"},
    timeout=10,
)
data = response.json()

<?php

$context = stream_context_create([
    "http" => ["header" => "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"],
]);

$data = json_decode(file_get_contents("https://api.currencyrates-api.com/v1/crypto/rates?base=USD", false, $context), true);

200 OK

{
  "base": "USD",
  "date": "2026-08-13",
  "updated_at": "2026-08-13T18:41:11Z",
  "rates": {
    "BTC": 0.0000094,
    "ETH": 0.00027,
    "SOL": 0.0061,
    "USDT": 0.9998
  }
}

GET/v1/crypto/convert

Convert crypto

Crypto to crypto or crypto to fiat in one call, with the applied rate returned alongside the result.

Parameter	Required	Description
from	yes	Source asset or currency code.
to	yes	Target asset or currency code.
amount	no	Amount in the source asset. Defaults to 1.

curl "https://api.currencyrates-api.com/v1/crypto/convert?from=BTC&to=USD&amount=1" \
  -H "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"

const response = await fetch("https://api.currencyrates-api.com/v1/crypto/convert?from=BTC&to=USD&amount=1", {
  headers: { Authorization: "Bearer fx_live_xxxxxxxxxxxxxxxxxx" },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.currencyrates-api.com/v1/crypto/convert?from=BTC&to=USD&amount=1",
    headers={"Authorization": "Bearer fx_live_xxxxxxxxxxxxxxxxxx"},
    timeout=10,
)
data = response.json()

<?php

$context = stream_context_create([
    "http" => ["header" => "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"],
]);

$data = json_decode(file_get_contents("https://api.currencyrates-api.com/v1/crypto/convert?from=BTC&to=USD&amount=1", false, $context), true);

200 OK

{
  "from": "BTC",
  "to": "USD",
  "amount": 1,
  "rate": 106382.97,
  "result": 106382.97,
  "date": "2026-08-13",
  "updated_at": "2026-08-13T18:41:11Z"
}

GET/v1/crypto/currencies

Cryptocurrency metadata

Names, symbols and decimal exponents for every supported digital asset.

This endpoint takes no parameters.

curl "https://api.currencyrates-api.com/v1/crypto/currencies" \
  -H "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"

const response = await fetch("https://api.currencyrates-api.com/v1/crypto/currencies", {
  headers: { Authorization: "Bearer fx_live_xxxxxxxxxxxxxxxxxx" },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.currencyrates-api.com/v1/crypto/currencies",
    headers={"Authorization": "Bearer fx_live_xxxxxxxxxxxxxxxxxx"},
    timeout=10,
)
data = response.json()

<?php

$context = stream_context_create([
    "http" => ["header" => "Authorization: Bearer fx_live_xxxxxxxxxxxxxxxxxx"],
]);

$data = json_decode(file_get_contents("https://api.currencyrates-api.com/v1/crypto/currencies", false, $context), true);

200 OK

{
  "date": "2026-08-13",
  "updated_at": "2026-08-13T18:41:11Z",
  "currencies": {
    "BTC": { "name": "Bitcoin", "symbol": "BTC", "exponent": 8, "type": "crypto" },
    "ETH": { "name": "Ethereum", "symbol": "ETH", "exponent": 18, "type": "crypto" }
  }
}