Documentation

Getting started

From an empty account to a live quote in four steps.

The shape of the API

Six endpoints across two markets: fiat under /v1 and crypto under /v1/crypto. Both markets answer the same field names, so a single client can serve either one.

Every response carries date and updated_at. updated_at is the moment the rate was captured upstream, which is the value you should store next to a charge.

Four steps

Create an account. The free plan activates immediately, with no payment method.
Subscribe to the currency product from the billing page.
Create an API key. The full secret is displayed once, so store it right away.
Send the key as a bearer token on any /v1 request.

Your first quote

cURL

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

Currency codes

Fiat currencies use ISO 4217 codes such as USD, BRL and EUR. Crypto assets use their ticker, such as BTC, ETH or USDT. Codes are case-insensitive on input and always uppercase in responses.

Not financial advice

Rates and conversions are informational. The API is not financial advice, a trading venue or a money-transmission service. Do not rely on a quote as the sole basis for executing a trade, settling a payment or meeting a regulatory obligation.

In your language

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

const params = new URLSearchParams({ from: "USD", to: "BRL", amount: "100" });

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

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(error.message);
}

const { rate, result, updated_at } = await response.json();
console.log(result, "at", rate, "captured", updated_at);

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

const { rates, updated_at } = await response.json();

// Persist the rate you charged, not just the result.
await db.quotes.insert({ pair: "USD/BRL", rate: rates.BRL, capturedAt: updated_at });

import requests

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

quote = response.json()
print(quote["rate"], quote["result"])

<?php

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

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

echo $payload["rates"]["BRL"];