Appearance
Coins Price List
Returns a paginated list of cryptocurrency prices ranked by market capitalization. Prices are expressed in any of 140+ supported fiat currencies.
Use this to:
- Build a live crypto market overview table
- Display top coins by market cap in a dashboard
- Track 24-hour price changes across the market
- Power a coin search or filter UI with real pricing data
Base URL
https://fast-price-exchange-rates.p.rapidapi.comGet coins price list
GET/api/v1/mini-crypto/prices
Returns a paginated envelope with coin data sorted by market cap descending.
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 | — | ISO 4217 fiat currency code to price coins in (e.g. USD, EUR, GBP). Supports 140+ currencies — see Fiat Symbols for the full list. |
| page | number | Yes | 1 | Page number (1-indexed). Used together with page_size to paginate through the ranked coin list. |
| page_size | number | Yes | 20 | Number of coins to return per page. Maximum: 100. |
Example requests
bash
curl "https://fast-price-exchange-rates.p.rapidapi.com/api/v1/mini-crypto/prices?base_currency=USD&page=1&page_size=20" \
-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/mini-crypto/prices?base_currency=USD&page=1&page_size=20',
{
headers: {
'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
'X-RapidAPI-Host': 'fast-price-exchange-rates.p.rapidapi.com',
},
}
)
const data = await response.json()
for (const coin of data.results) {
const change = coin.change_24h_percent >= 0
? `+${coin.change_24h_percent}%`
: `${coin.change_24h_percent}%`
console.log(`#${coin.rank} ${coin.symbol} — $${coin.price.toFixed(2)} (${change})`)
}javascript
async function getTop100(baseCurrency = 'USD') {
const headers = {
'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
'X-RapidAPI-Host': 'fast-price-exchange-rates.p.rapidapi.com',
}
const pages = [1, 2, 3, 4, 5] // 5 pages × 20 = 100 coins
const results = []
for (const page of pages) {
const url = `https://fast-price-exchange-rates.p.rapidapi.com/api/v1/mini-crypto/prices?base_currency=${baseCurrency}&page=${page}&page_size=20`
const res = await fetch(url, { headers })
const data = await res.json()
results.push(...data.results)
}
return results
}
const top100 = await getTop100('EUR')
console.log(`Fetched ${top100.length} coins priced in EUR`)python
import os
import requests
response = requests.get(
"https://fast-price-exchange-rates.p.rapidapi.com/api/v1/mini-crypto/prices",
params={"base_currency": "USD", "page": 1, "page_size": 20},
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"Page {data['page']} — {data['page_size']} coins in {data['base_currency']}\n")
print(f"{'#':<5} {'Symbol':<8} {'Name':<22} {'Price':>14} {'24h':>8}")
print("-" * 65)
for coin in data["results"]:
change = f"{coin['change_24h_percent']:+.2f}%"
print(f"{coin['rank']:<5} {coin['symbol']:<8} {coin['name']:<22} {coin['price']:>14.4f} {change:>8}")python
import os, requests
headers = {
"X-RapidAPI-Key": os.environ["RAPIDAPI_KEY"],
"X-RapidAPI-Host": "fast-price-exchange-rates.p.rapidapi.com",
}
all_coins = []
for page in range(1, 6): # pages 1-5, 20 per page = 100 total
r = requests.get(
"https://fast-price-exchange-rates.p.rapidapi.com/api/v1/mini-crypto/prices",
params={"base_currency": "USD", "page": page, "page_size": 20},
headers=headers,
)
r.raise_for_status()
all_coins.extend(r.json()["results"])
print(f"Total coins fetched: {len(all_coins)}")Response
json
{
"page": 1,
"page_size": 20,
"base_currency": "USD",
"results": [
{
"rank": 1,
"symbol": "BTC",
"name": "Bitcoin",
"slug": "bitcoin",
"id": "rx5wufxh",
"price": 89386.89996834408,
"image": "https://market-assets.fsn1.your-objectstorage.com/crypto/rx5wufxh.png",
"market_cap": 1784372582583.07,
"change_24h_percent": 0.18
},
{
"rank": 2,
"symbol": "ETH",
"name": "Ethereum",
"slug": "ethereum",
"id": "6uz3nomy",
"price": 3136.1868841129062,
"image": "https://market-assets.fsn1.your-objectstorage.com/crypto/6uz3nomy.png",
"market_cap": 378522415450,
"change_24h_percent": 1.47
},
{
"rank": 3,
"symbol": "USDT",
"name": "Tether",
"slug": "tether",
"id": "lnkbsqlv",
"price": 0.9679315228416964,
"image": "https://market-assets.fsn1.your-objectstorage.com/crypto/lnkbsqlv.png",
"market_cap": 180278389860.74,
"change_24h_percent": -0.02
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
| page | number | Current page number. |
| page_size | number | Number of results returned on this page. |
| base_currency | string | The fiat currency all prices are expressed in. |
| results | array | List of coin objects, sorted by market cap descending. |
Coin object fields
| Field | Type | Description |
|---|---|---|
| rank | number | Market cap rank (1 = largest). |
| symbol | string | Ticker symbol (e.g. BTC, ETH, SOL). |
| name | string | Full coin name (e.g. Bitcoin, Ethereum). |
| slug | string | URL-friendly identifier (e.g. bitcoin, lido-staked-ether). |
| id | string | Internal unique identifier for the coin. |
| price | number | Current price in the requested base_currency. |
| image | string | URL to the coin's logo image (PNG). |
| market_cap | number | Market capitalization in the requested base_currency. |
| change_24h_percent | number | Price change over the last 24 hours as a percentage. Positive = up, negative = down. |
Error responses
| Status | Code | Description |
|---|---|---|
| 400 | bad_request | Missing or invalid parameter (e.g. unsupported base_currency, page_size > 100) |
| 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 |
|---|---|
| Fiat Symbols | Full list of supported fiat currency codes |
| Fast Price API Overview | All endpoints in the Fast Price API |