Skip to content

Fiat From Base

Returns live exchange rates from a specified fiat base currency to all other supported fiat currencies. Covers 150+ ISO 4217 currencies.

Use this to:

  • Display multi-currency prices in an e-commerce checkout
  • Power a fiat currency converter widget
  • Populate a rate table for financial dashboards
  • Perform batch currency conversions with a single API call

Base URL

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

Get fiat rates from base

GET/api/v1/convert-rates/fiat/from

Returns an object with the base currency and a map of all target fiat currencies to their exchange rates.

Authentication

HeaderValue
X-RapidAPI-KeyYour RapidAPI secret key
X-RapidAPI-Hostfast-price-exchange-rates.p.rapidapi.com

Query parameters

ParameterTypeRequiredDescription
currencystringYesISO 4217 base currency code (e.g. USD, EUR, GBP). The response will express all rates relative to 1 unit of this currency.
detailedbooleanNo When false (default): keys in the to object are plain ISO codes ("EUR", "JPY").
When true: keys include the full name and asset type ("EUR:EURO:FIAT"), useful for display labels without an extra lookup.

Example requests

bash
curl "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/fiat/from?currency=USD&detailed=false" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fast-price-exchange-rates.p.rapidapi.com"
bash
curl "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/fiat/from?currency=USD&detailed=true" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fast-price-exchange-rates.p.rapidapi.com"
javascript
const response = await fetch(
  'https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/fiat/from?currency=USD&detailed=false',
  {
    headers: {
      'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
      'X-RapidAPI-Host': 'fast-price-exchange-rates.p.rapidapi.com',
    },
  }
)

const data = await response.json()

// Convert 100 USD to EUR
const amount = 100
const eurRate = data.to['EUR']
console.log(`${amount} USD = ${(amount * eurRate).toFixed(2)} EUR`)
javascript
const response = await fetch(
  'https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/fiat/from?currency=USD&detailed=true',
  {
    headers: {
      'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
      'X-RapidAPI-Host': 'fast-price-exchange-rates.p.rapidapi.com',
    },
  }
)

const data = await response.json()

// Parse detailed key format: "CODE:FULL NAME:FIAT"
const currencies = Object.entries(data.to).map(([key, rate]) => {
  const [code, name] = key.split(':')
  return { code, name, rate }
})

// Display top 5 by rate (highest first)
currencies
  .sort((a, b) => b.rate - a.rate)
  .slice(0, 5)
  .forEach(({ code, name, rate }) => {
    console.log(`${code} (${name}): ${rate.toFixed(4)}`)
  })
python
import os
import requests

response = requests.get(
    "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/fiat/from",
    params={"currency": "USD", "detailed": "false"},
    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()

# Convert 250 USD to several currencies
amount = 250
for code in ["EUR", "GBP", "JPY", "CAD", "CHF"]:
    rate = data["to"][code]
    print(f"{amount} USD → {amount * rate:.2f} {code}")
python
import os
import requests

response = requests.get(
    "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/fiat/from",
    params={"currency": "USD", "detailed": "true"},
    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()

# Parse "CODE:FULL NAME:FIAT" keys
rows = []
for key, rate in data["to"].items():
    code, name, _ = key.split(":")
    rows.append((code, name, rate))

# Print sorted alphabetically by code
rows.sort()
print(f"{'Code':<6} {'Name':<45} Rate")
print("-" * 70)
for code, name, rate in rows[:10]:
    print(f"{code:<6} {name:<45} {rate:.6f}")

Response — detailed=false

json
{
  "from": "USD",
  "to": {
    "AED": 3.6728013731458162,
    "AFN": 64.71054424641723,
    "ALL": 81.89134982055863,
    "AMD": 376.0597305680834,
    "ARS": 1381.9607607979424,
    "AUD": 1.4198113530093084,
    "BRL": 5.0861422107225245,
    "CAD": 1.381715477711771,
    "CHF": 0.7921887364072324,
    "CNY": 6.83490419468795,
    "EUR": 0.8436933346454653,
    "GBP": 0.7491693643827342,
    "JPY": 159.23017759072337,
    "USD": 1,
    "..."  : "... 150+ currencies total"
  }
}

Response — detailed=true

json
{
  "from": "USD",
  "to": {
    "AED:UNITED ARAB EMIRATES DIRHAM:FIAT": 3.666453291193232,
    "AFN:AFGHAN AFGHANI:FIAT": 64.70801172821858,
    "ALL:ALBANIAN LEK:FIAT": 81.87010559489238,
    "EUR:EURO:FIAT": 0.8451476203977013,
    "GBP:BRITISH POUND:FIAT": 0.7494781686705793,
    "JPY:JAPANESE YEN:FIAT": 159.23285616314695,
    "USD:UNITED STATES DOLLAR:FIAT": 1,
    "..."  : "... 150+ currencies total"
  }
}

Response fields

FieldTypeDescription
fromstringThe ISO 4217 code of the base currency (mirrors the currency query parameter).
toobject Map of target currencies to their exchange rates. One unit of from equals rate units of the target currency.

Key format depends on the detailed parameter:
false: plain ISO code — "EUR"
true: "CODE:FULL NAME:FIAT""EUR:EURO:FIAT"

Key format (detailed=true)

CODE:FULL NAME:FIAT
 │       │      └─ asset type, always "FIAT" for this endpoint
 │       └─ full English name of the currency
 └─ ISO 4217 three-letter code

Example: "EUR:EURO:FIAT": 0.845

Conversion formula

targetAmount = sourceAmount × rate

To convert in the reverse direction (e.g. EUR → USD when base is USD):

sourceAmount = targetAmount / rate

Error responses

StatusCodeDescription
400bad_requestcurrency parameter is missing or not a valid ISO 4217 code
401unauthorizedX-RapidAPI-Key is missing or invalid
403forbiddenYour RapidAPI plan does not include access to this endpoint
429too_many_requestsRapidAPI rate limit exceeded
500internal_errorServer error — safe to retry after a short delay

EndpointDescription
Fast Price API OverviewAll endpoints in the Fast Price API

Released under the MIT License.