Coverage
What you get
| Item | Detail |
|---|---|
| Product code | CR-PRICES |
| Coverage | Top 1,000 coins on Free; all coins we carry from Starter |
| Granularity | Latest value only. History lives in crypto historical data |
| Price method | Volume-weighted across the venues we cover, quoted against USD |
| Delivery | REST on all plans; WebSocket stream on Pro |
| Update speed | 60-second cache on Free; real-time from Starter |
This is the feed behind a portfolio page or a coin screener: price, 24-hour change, market cap, supply and rank. It's not built for backtests. For that you want bars per exchange, which is a separate product.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Pair in our format, e.g. BTC-USD |
asset_id |
string | yes | Our stable coin id, e.g. bitcoin |
name |
string | yes | e.g. Bitcoin |
timestamp |
string | yes | Last update, ISO 8601 UTC |
price |
number | yes | Volume-weighted price across covered venues |
bid |
number | optional | Best bid |
ask |
number | optional | Best ask |
volume_24h |
number | yes | 24h volume in quote currency |
change_24h_pct |
number | yes | Percent change over 24h |
change_7d_pct |
number | optional | Percent change over 7 days |
high_24h |
number | optional | 24h high |
low_24h |
number | optional | 24h low |
market_cap |
number | yes | price times circulating supply |
fully_diluted_market_cap |
number | optional | price times max or total supply |
market_cap_rank |
integer | yes | Rank by market cap |
circulating_supply |
number | yes | Coins in circulation |
total_supply |
number | optional | Total coins issued |
max_supply |
number | optional | Hard cap, null if none |
Example record (illustrative values, not a live price):
{
"symbol": "BTC-USD",
"asset_id": "bitcoin",
"name": "Bitcoin",
"timestamp": "2026-11-19T14:32:00Z",
"price": 77612.4,
"bid": 77611.9,
"ask": 77612.8,
"volume_24h": 31845221904.5,
"change_24h_pct": 1.42,
"change_7d_pct": -3.18,
"high_24h": 78204.1,
"low_24h": 76118.6,
"market_cap": 1544120387221.0,
"fully_diluted_market_cap": 1629860400000.0,
"market_cap_rank": 1,
"circulating_supply": 19895412,
"total_supply": 19895412,
"max_supply": 21000000
}
Sample data
Sample data
A latest-price feed has nothing to put in a static file, so the closest real sample is daily candles for five large altcoins. Altcoin Daily OHLCV (SOL, XRP, BNB, DOGE, ADA), July to October 2026. First 10 rows:
| symbol | interval | timestamp | open | high | low | close | volume | quote_volume | vwap | trade_count | taker_buy_volume |
|---|---|---|---|---|---|---|---|---|---|---|---|
| SOL-USDT | 1d | 2026-07-01T00:00:00Z | 73.67 | 78.96 | 72.25 | 77.46 | 3613325.296 | 274424470.63 | 75.95 | 1293054 | 1856247.269 |
| SOL-USDT | 1d | 2026-07-02T00:00:00Z | 77.46 | 82.78 | 76.9 | 80.73 | 3740503.81 | 300710638.26 | 80.39 | 1323576 | 1935430.422 |
| SOL-USDT | 1d | 2026-07-03T00:00:00Z | 80.72 | 83.22 | 80.34 | 82.34 | 1769217.383 | 144331402.98 | 81.58 | 747224 | 884135.599 |
| SOL-USDT | 1d | 2026-07-04T00:00:00Z | 82.35 | 83.98 | 81.36 | 81.8 | 1853790.462 | 152670026.21 | 82.36 | 623191 | 882867.569 |
| SOL-USDT | 1d | 2026-07-05T00:00:00Z | 81.8 | 82.43 | 79.68 | 81.59 | 1405482.139 | 113832056.83 | 80.99 | 531552 | 694830.758 |
| SOL-USDT | 1d | 2026-07-06T00:00:00Z | 81.59 | 83.74 | 79.23 | 81.94 | 2393607.64 | 194348694.83 | 81.19 | 1012792 | 1295746.385 |
| SOL-USDT | 1d | 2026-07-07T00:00:00Z | 81.94 | 82.79 | 80.34 | 80.58 | 1858989.517 | 151356556.01 | 81.42 | 835044 | 937684.733 |
| SOL-USDT | 1d | 2026-07-08T00:00:00Z | 80.58 | 80.78 | 76.29 | 77.83 | 2171403.36 | 169124947.01 | 77.89 | 786423 | 1049041.575 |
| SOL-USDT | 1d | 2026-07-09T00:00:00Z | 77.83 | 78.83 | 76.71 | 78.04 | 1458437.834 | 113612885.36 | 77.9 | 628012 | 713779.583 |
| SOL-USDT | 1d | 2026-07-10T00:00:00Z | 78.05 | 79.68 | 77.07 | 78.13 | 1853732.075 | 145485169.22 | 78.48 | 600906 | 970031.561 |
Source: Binance
Use cases
Use cases
Portfolio valuation. Multiply each holding by price and sum. Store timestamp with the result so you know how fresh the valuation is, which matters on Free where prices are cached for 60 seconds.
Coin screeners. Sort by market_cap_rank, then filter on volume_24h to drop coins that rank high but barely trade. change_7d_pct adds a simple momentum column.
Dilution check. Compare market_cap with fully_diluted_market_cap. A big gap means a lot of supply is still to be released, which can weigh on price for years.
Price alerts. Poll price and change_24h_pct on Starter, or subscribe to the stream on Pro, and fire an alert when a coin crosses your level.
Code
Code examples
Example: latest price for three coins.
curl "https://api.marketdata.co/v1/crypto/prices?symbols=BTC-USD,ETH-USD,SOL-USD" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, top 20 by market cap with supply ratio.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/crypto/prices",
params={"sort": "market_cap_rank", "limit": 20},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
top = pd.DataFrame(resp.json()["results"])
top["float_ratio"] = top["market_cap"] / top["fully_diluted_market_cap"]
print(top[["market_cap_rank", "symbol", "price", "change_24h_pct", "float_ratio"]])
Pricing
Pricing
| Plan | Crypto prices |
|---|---|
| Free, $0 | 60-second cached prices, top 1,000 coins, 10,000 calls a month |
| Starter, $29/mo | Real-time REST for all coins |
| Pro, $79/mo | Adds the WebSocket stream |
| Business, $249/mo | Commercial display |
Latest prices aren't sold as a dataset; buy historical bars for history. Among the providers we studied, many have a free tier, and paid plans run from $22 to $1,680 a month, median $49.
Side by side
How we compare
15 of the 50 providers we studied sell a crypto price feed, and the best-known ones offer a free tier with paid plans around $29 to $35. We match that: free 60-second prices, real-time at $29. The difference is that the same symbol keys work in our bars, trades and funding endpoints, so a tracker can grow into a backtester without changing data vendors.
FAQ
Frequently asked questions
How is the price calculated?
price is a volume-weighted average across the venues we cover, quoted in USD. For one exchange's price, use historical bars or the trades feed with an exchange filter.
How is the 24-hour window measured?
It is a rolling 24 hours ending at timestamp, not a calendar day. Crypto trades all week, so there is no daily close to measure from.
How fresh is the free tier?
Free prices are cached for up to 60 seconds. Starter and up get real-time values on every request.
Is market cap adjusted for locked tokens?
market_cap uses circulating supply. fully_diluted_market_cap uses max supply, or total supply where no cap exists, so you can see both views.
Can I show these prices in a public app?
Commercial display starts at Business ($249 a month). Free, Starter and Pro are for personal use.
Keep reading
Related
- Asset hub: Crypto
- Symbols: BTC-USD, ETH-USD, SOL-USD, XRP-USD, BNB-USD, DOGE-USD
- Docs: API Reference: Crypto Prices, Bars and Trades
- Learn: What Is OHLCV Data and How Traders Use It, How to Choose a Market Data Provider