API Reference
Log In
API Reference

Coins List with Market Data

This endpoint allows you to query all the supported coins with price, market cap, volume and market related data

👍

Tips

  • You can retrieve specific coins using their unique ids, names, or symbols instead of returning the whole list.
  • To filter results based on the coin's category, use the category param (refer to /coins/categories/list for available categories).
  • Use the per_page and page params to manage the number of results you receive and navigate through the data.
📘

Notes

  • When multiple lookup params are provided, the following priority order is applied: category (highest) > ids > names > symbols (lowest).
  • When searching by name, you need to URL-encode any spaces (e.g. "Binance Coin" becomes "Binance%20Coin").
  • The include_tokens=all param is exclusively for use with the symbols lookup and is limited to maximum of 50 symbols per request.
  • Wildcard searches are not supported for lookup params (ids, names, symbols).
  • Cache/Update Frequency:
    • Every 60 seconds for Public API.
    • Every 45 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
Query Params
string
required

target currency of coins and market data
*refers to /simple/supported_vs_currencies.

string

coins' IDs, comma-separated if querying more than 1 coin.
*refers to /coins/list.

string

coins' names, comma-separated if querying more than 1 coin.

string

coins' symbols, comma-separated if querying more than 1 coin.

string
enum

for symbols lookups, specify all to include all matching tokens
Default top returns top-ranked tokens (by market cap or volume)

Allowed:
string

filter based on coins' category
*refers to /coins/categories/list.

string
enum

sort result by field, default: market_cap_desc

Allowed:
integer

total results per page, default: 100
Valid values: 1...250

integer

page through results, default: 1

boolean

include sparkline 7 days data, default: false

string

include price change percentage timeframe, comma-separated if query more than 1 price change percentage timeframe
Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y

string
enum

language background, default: en

string
enum

decimal place for currency price value

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json