Skip to content

Crypto From Base

Returns live exchange rates from a specified base currency to all supported cryptocurrencies. The base can be either a fiat currency (e.g. USD) or a cryptocurrency (e.g. BTC).

Use this to:

  • Convert a fiat or crypto amount to any coin with a single call
  • Build an "exchange calculator" that shows how much of every coin you'd get
  • Compare crypto-to-crypto rates across thousands of pairs
  • Power a portfolio valuation tool across multiple base currencies

Base URL

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

Get crypto rates from base

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

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

Authentication

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

Query parameters

ParameterTypeRequiredDescription
currencystringYes Base currency code. Accepts both fiat and crypto symbols.

Examples: BTC, ETH, USD, EUR
Use Crypto Symbols to get the full list of supported crypto codes, or Fiat Symbols for fiat codes.
detailedbooleanNo When false (default): keys in the to object are plain ticker symbols ("ETH", "ADA").
When true: keys include the full name and asset type ("ETH:ETHEREUM:CRYPTO").

Example requests

bash
curl "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/crypto/from?currency=BTC&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/crypto/from?currency=BTC&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/crypto/from?currency=BTC&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()

// How much ETH does 0.5 BTC buy?
const btcAmount = 0.5
const ethRate = data.to['ETH']
console.log(`${btcAmount} BTC = ${(btcAmount * ethRate).toFixed(4)} ETH`)

// How much ADA does 1 BTC buy?
const adaRate = data.to['ADA']
console.log(`1 BTC = ${data.to['ADA'].toLocaleString()} ADA`)
javascript
const response = await fetch(
  'https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/crypto/from?currency=BTC&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 "SYMBOL:NAME:CRYPTO" keys
const coins = Object.entries(data.to).map(([key, rate]) => {
  const [symbol, name] = key.split(':')
  return { symbol, name, rate }
})

// Find major coins
const major = ['ETH', 'SOL', 'ADA', 'BNB', 'XRP']
coins
  .filter(c => major.includes(c.symbol))
  .forEach(({ symbol, name, rate }) => {
    console.log(`1 BTC = ${rate.toLocaleString()} ${symbol} (${name})`)
  })
python
import os
import requests

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

# Show rates for a few well-known coins
major = ["ETH", "SOL", "ADA", "BNB", "XRP", "DOGE", "LINK"]
print(f"1 {data['from']} equals:")
for symbol in major:
    rate = data["to"].get(symbol)
    if rate:
        print(f"  {rate:>15,.4f} {symbol}")
python
import os
import requests

response = requests.get(
    "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/convert-rates/crypto/from",
    params={"currency": "BTC", "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 "SYMBOL:NAME:CRYPTO" keys
coins = []
for key, rate in data["to"].items():
    symbol, name, _ = key.split(":")
    coins.append((symbol, name, rate))

print(f"Total crypto targets: {len(coins)}")
print()

# Top 5 by rate (most of that coin per 1 BTC)
top5 = sorted(coins, key=lambda x: x[2], reverse=True)[:5]
for symbol, name, rate in top5:
    print(f"1 BTC = {rate:>20,.0f} {symbol} ({name})")

Response — detailed=false

json
{
  "from": "BTC",
  "to": {
    "00": 15684719.105576117,
    "1INCH": 777652.709374958,
    "A8": 7389074.633253605,
    "AAVE": 795.5325962195878,
    "ADA": 285527.36763565685,
    "ALGO": 649919.3819042471,
    "APT": 85282.00142730404,
    "ARB": 646316.398394685,
    "ETH": 28.451,
    "SOL": 674.2,
    "...": "... thousands of crypto tokens total"
  }
}

Response — detailed=true

json
{
  "from": "BTC",
  "to": {
    "00:00 TOKEN:CRYPTO": 15679381.234483056,
    "1INCH:1INCH TOKEN:CRYPTO": 777388.0521503396,
    "A8:ANCIENT8:CRYPTO": 7386559.961003256,
    "AAVE:AAVE:CRYPTO": 794.8567343448417,
    "ADA:CARDANO:CRYPTO": 285418.51506283163,
    "ALGO:ALGORAND:CRYPTO": 649700.0,
    "ETH:ETHEREUM:CRYPTO": 28.445,
    "SOL:SOLANA:CRYPTO": 673.8,
    "...": "... thousands of crypto tokens total"
  }
}

Response fields

FieldTypeDescription
fromstringThe base currency code (mirrors the currency query parameter).
toobject Map of target crypto symbols to exchange rates. Each value represents how many units of the target crypto equal 1 unit of the base currency.

Key format depends on the detailed parameter:
false: plain ticker — "ADA"
true: "SYMBOL:FULL NAME:CRYPTO""ADA:CARDANO:CRYPTO"

Key format (detailed=true)

SYMBOL:FULL NAME:CRYPTO
  │        │        └─ asset type, always "CRYPTO" for this endpoint
  │        └─ full coin name in uppercase
  └─ ticker symbol

Example: "ADA:CARDANO:CRYPTO": 285418 — 1 BTC = 285,418 ADA

Conversion formula

targetAmount = baseAmount × rate

To convert in the reverse direction (e.g. ADA back to BTC):

baseAmount = targetAmount / rate

Error responses

StatusCodeDescription
400bad_requestcurrency parameter is missing or not a recognized fiat/crypto 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
Crypto To QuoteRates from all cryptos to a single quote currency
Coins Price ListPaginated live prices ranked by market cap
Fiat SymbolsSupported fiat currency codes

Released under the MIT License.