Convert Currency

Converts a specific amount from a base currency to one or more quote currencies. Accepts any fiat or crypto symbol on either side, and supports multiple targets in a single request.

Use this to:

• Show a user exactly how much they'd receive when converting a specific amount
• Display a converted price in several currencies at checkout
• Build a spot-rate converter widget
• Get targeted conversions without processing a full rate table

Base URL

https://fast-price-exchange-rates.p.rapidapi.com

---

Convert an amount

GET/api/v1/convert

Returns the converted value of amount units of base_currency expressed in each of the requested quote_currency targets.

Authentication

Header	Value
X-RapidAPI-Key	Your RapidAPI secret key
X-RapidAPI-Host	fast-price-exchange-rates.p.rapidapi.com

Query parameters

Parameter	Type	Required	Default	Description
base_currency	string	Yes	—	The source currency to convert from. Accepts any fiat ISO code or crypto ticker (e.g. EUR, BTC, ETH).
quote_currency	string	Yes	—	One or more target currencies to convert into, comma-separated (e.g. USD, USD,BTC,ETH). Accepts fiat and crypto symbols.
amount	number	No	1	The amount of base_currency to convert. Defaults to 1 if omitted.

---

Example requests

cURL — single target

curl "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert?amount=100&base_currency=EUR&quote_currency=USD" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fast-price-exchange-rates.p.rapidapi.com"

cURL — multiple targets

curl "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert?amount=1&base_currency=EUR&quote_currency=USD%2CBTC" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fast-price-exchange-rates.p.rapidapi.com"

JavaScript

// Convert 250 EUR to USD, BTC, and ETH
const params = new URLSearchParams({
  amount: 250,
  base_currency: 'EUR',
  quote_currency: 'USD,BTC,ETH',
})

const response = await fetch(
  `https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert?${params}`,
  {
    headers: {
      'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
      'X-RapidAPI-Host': 'fast-price-exchange-rates.p.rapidapi.com',
    },
  }
)

const data = await response.json()

console.log(`Converting ${params.get('amount')} ${data.from}:`)
for (const [currency, value] of Object.entries(data.to)) {
  console.log(`  → ${value.toFixed(6)} ${currency}`)
}

JavaScript — checkout display

async function getCheckoutPrices(amountEur, currencies = ['USD', 'GBP', 'JPY', 'BTC']) {
  const params = new URLSearchParams({
    amount: amountEur,
    base_currency: 'EUR',
    quote_currency: currencies.join(','),
  })

  const response = await fetch(
    `https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert?${params}`,
    {
      headers: {
        'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
        'X-RapidAPI-Host': 'fast-price-exchange-rates.p.rapidapi.com',
      },
    }
  )

  const data = await response.json()
  return data.to
}

const prices = await getCheckoutPrices(49.99)
console.log(prices)
// { USD: 58.77, GBP: 37.44, JPY: 7960.3, BTC: 0.000815 }

Python

import os
import requests

response = requests.get(
    "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert",
    params={
        "amount": 1000,
        "base_currency": "USD",
        "quote_currency": "EUR,GBP,JPY,BTC,ETH,SOL",
    },
    headers={
        "X-RapidAPI-Key": os.environ["RAPIDAPI_KEY"],
        "X-RapidAPI-Host": "fast-price-exchange-rates.p.rapidapi.com",
    },
)

response.raise_for_status()
data = response.json()

print(f"Converting 1000 {data['from']}:\n")
for currency, value in data["to"].items():
    print(f"  {currency:<6} {value:.6f}")

Python — helper function

import os
import requests

def convert(amount: float, base: str, *targets: str) -> dict:
    response = requests.get(
        "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert",
        params={
            "amount": amount,
            "base_currency": base,
            "quote_currency": ",".join(targets),
        },
        headers={
            "X-RapidAPI-Key": os.environ["RAPIDAPI_KEY"],
            "X-RapidAPI-Host": "fast-price-exchange-rates.p.rapidapi.com",
        },
    )
    response.raise_for_status()
    return response.json()["to"]

result = convert(500, "GBP", "USD", "EUR", "BTC")
print(result)
# {'USD': 666.5, 'EUR': 591.2, 'BTC': 0.00744}

---

Response

{
  "from": "EUR",
  "to": {
    "USD": 1.1756379693996346,
    "BTC": 0.000016298695472464265
  }
}

Response fields

Field	Type	Description
from	string	The base currency code (mirrors base_currency).
to	object	Map of each requested quote currency to the converted amount. Values represent amount × rate — the actual quantity of the target currency you would receive.

Multiple targets in one call

Pass a comma-separated list to quote_currency to convert to several currencies at once:

quote_currency=USD,EUR,GBP,BTC,ETH

This is more efficient than making one request per target currency.

---

Error responses

Status	Code	Description
400	bad_request	Missing required parameter or unrecognized currency code
401	unauthorized	X-RapidAPI-Key is missing or invalid
403	forbidden	Your RapidAPI plan does not include access to this endpoint
429	too_many_requests	RapidAPI rate limit exceeded
500	internal_error	Server error — safe to retry after a short delay

---

Related endpoints

Endpoint	Description
All From Base	Rates from a base to all fiat and crypto in one call
Fiat Symbols	Supported fiat currency codes
Crypto Symbols	Supported crypto ticker symbols