List of coins

Get a list of coins. On Coinranking, we use this endpoint on our home page.

Be aware that by default the list includes coins with tier 1, 2 and 3. This results in little-known coins with large market caps ranking on top. If you only want to show 'quality coins', then you should filter on tier 1.

Coins are by default ordered by their rank, which - somewhat simplified - means that they are ordered on market cap. See more details about are ranking in our ranking methodology. The response not only returns a list of coins, but also statistics regarding the requested list, such as the volume in the last 24 hours. If you need all our coins at once, check out our bulk endpoint.

https://api.coinranking.com/v2/coins

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint

Default value: yhjMzLPhuIDl

Example:
...coins?referenceCurrencyUuid=Qwsogvtv82FCd
timePeriod (optional) String

By setting the timePeriod the change percentage and sparkline in the response will be calculated accordingly.

Default value: 24h
Allowed values:
1h 3h 12h 24h 7d 30d 3m 1y 3y 5y

Example:
...coins?timePeriod=7d
symbols (optional) Array

Symbols to filter the list on. Do note that symbols are not unique. Should you need a specific coin, then you should use the UUIDs filter.

Example:
...coins?symbols[]=BTC&symbols[]=ETH&symbols[]=XRP
contractAddresses (optional) Array

Contract Addresses to filter the list on. These are the addresses currencies get on their respective blockchains. Smart Contract Addresses are a common name for addresses on blockchains, but some chains might call them AssetID, Token Address or something else. We use the term Contract Address to cover all these cases. Note that tokens might be issued on several blockchains, so the same token might have several addresses

Example:
...coins?contractAddresses[]=0xdac...&contractAddresses[]=0xa0...
blockchains (optional) Array

Blockchains to filter the list on. With this filter you can for example fetch only coins that are minted on the Ethereum blockchain. You can filter on multiple blockchains at once.

Example:
...coins?blockchains[]=ethereum&blockchain[]=eos
uuids (optional) Array

UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins.

Example:
...coins?uuids[]=razxDUgYGNAdQ&uuids[]=Qwsogvtv82FCd
tiers (optional) Array

We separate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about our tiers in our ranking methodology.

Allowed values:
1 2 3

Example:
...coins?tiers[]=1&tiers[]=2
tags (optional) Array

Tags to filter the list on.

Allowed values:
defi stablecoin nft dex exchange staking dao meme privacy metaverse gaming wrapped layer-1 layer-2 fan-token football-club web3 social

Example:
...coins?tags[]=defi
orderBy (optional) String

Index to order by. All sortings excluding listedAt still take our different tiers of coins into account, read more about it in our ranking methodology.

Default value: marketCap
Allowed values:
price marketCap 24hVolume change listedAt

Example:
...coins?orderBy=price
orderDirection (optional) String

Applies direction to the orderBy query, which can be in ascending or descending order.

Default value: desc
Allowed values:
desc asc

Example:
...coins?orderDirection=asc
limit (optional) Number

Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 0-5000

Example:
...coins?limit=10
offset (optional) Number

Offset. Used for pagination.

Default value: 0

Example:
...coins?offset=50
cursor (optional) String

Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information.

Example:
...coins?cursor=eyJ0IjoxLC...

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "stats": {
      "total": 2273,
      "totalCoins": 971310,
      "totalMarkets": 50511,
      "totalExchanges": 182,
      "totalMarketCap": "1376",
      "total24hVolume": "44245860077"
    },
    "coins": [
      {
        "uuid": "Qwsogvtv82FCd",
        "symbol": "BTC",
        "name": "Bitcoin",
        "color": "#f7931A",
        "iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
        "marketCap": "1779096815287",
        "price": "89086.46601791566",
        "listedAt": 1279324800,
        "tier": 1,
        "change": "1.57",
        "rank": 1,
        "sparkline": [
          "87718.8185434618",
          "87831.39433828383",
          "87836.10177573239",
          "87912.74493308847",
          "87977.64124779409",
          "87954.06958585513",
          "87902.17541952957",
          "87991.8873160424",
          "87954.18221848007",
          "88217.27415928514",
          "88182.16973342402",
          "88208.09873175608",
          "88309.85722338042",
          "88336.9764258353",
          "88518.80305035008",
          "88722.70658713221",
          "88724.27935862185",
          "88686.60718391473",
          "88494.28083727155",
          "88867.71449962979",
          "88805.76669118676",
          "88678.39255061348",
          "88899.3524002099",
          "88933.14664142062"
        ],
        "allTimeHigh": {
          "price": "126077.50026839285",
          "timestamp": 1759777080
        },
        "lowVolume": false,
        "coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
        "24hVolume": "14545165374",
        "btcPrice": "1",
        "contractAddresses": [],
        "isWrappedTrustless": false,
        "wrappedTo": null
      },
      {
        "uuid": "razxDUgYGNAdQ",
        "symbol": "ETH",
        "name": "Ethereum",
        "color": "#3C3C3D",
        "iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
        "marketCap": "365416480388",
        "price": "3027.6051673910147",
        "listedAt": 1438905600,
        "tier": 1,
        "change": "1.58",
        "rank": 2,
        "sparkline": [
          "2980.7093448538035",
          "2984.3177952979577",
          "2983.574966964519",
          "2986.9614020462695",
          "2986.431020097484",
          "2985.605255653924",
          "2981.6559156798207",
          "2985.8651716513355",
          "2984.352437768829",
          "2989.8717819210347",
          "2989.320200751151",
          "2990.589780403958",
          "2991.566939536146",
          "2990.4993421748177",
          "2992.936561567808",
          "3003.46376443117",
          "3002.5348825667547",
          "3003.5666225838786",
          "2998.349421388807",
          "3015.7495392109827",
          "3017.700562537228",
          "3013.3112528163515",
          "3023.711269385133",
          "3024.369021905459"
        ],
        "allTimeHigh": {
          "price": "4945.666895424594",
          "timestamp": 1756062720
        },
        "lowVolume": false,
        "coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth",
        "24hVolume": "9602051748",
        "btcPrice": "0.03398501818202274",
        "contractAddresses": [],
        "isWrappedTrustless": false,
        "wrappedTo": null
      }
    ]
  },
  "pagination": {
    "limit": 50,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "nextCursor": "eyJ0IjoxLCJyIjoyLCJ1IjoiSElWc1JjR0trUEZ0VyIsIm8iOiJtYXJrZXRDYXAiLCJkIjoiZGVzYyJ9",
    "previousCursor": null
  }
}

Response fields

Property Description
status String

Status of the request

Allowed values:
success
data Object
data.stats Object

A series of statistics regarding the requested list. Note that the stats its scope includes coins outside the limit. E.g. the response of a query with a limit of 50 coins returns 50 coins (obviously), while the stats depicts the amount of coins available, 24 hour volume, etc. without this limit, which may be a much higher number.

data.stats.total Number

Total number of coins within the query
data.stats.totalCoins Number

Total number of coins without the filters
data.stats.totalMarkets Number

Total number of markets without the filters
data.stats.totalExchanges Number

Total number of exchanges without the filters
data.stats.totalMarketCap String

The market capital of coins without the filters
data.stats.total24hVolume String

The volume over the last 24 hours of coins without the filters
data.coins Object[]

List of coins
data.coins.uuid String

UUID of the coin
data.coins.symbol String

Currency symbol
data.coins.name String

Name of the coin
data.coins.color String

Main HEX color of the coin
data.coins.iconUrl String

Location of the icon
data.coins.24hVolume String

24h trade volume
data.coins.marketCap String

Market capitalization. Price times circulating supply
data.coins.price String

Price of the coin
data.coins.btcPrice String

Price of the coin expressed in Bitcoin
data.coins.listedAt Number/null

Epoch timestamp of when we started listing the coin.
data.coins.tier Number/null

Tier of the coin. We separate coins into three tiers. Learn more about our ranking methodology.
data.coins.change String

Percentage of change over the given time period
data.coins.rank Number

The position in the ranks
data.coins.sparkline String

Array of prices based on the time period parameter, useful for a sparkline
data.coins.allTimeHigh Object
data.coins.allTimeHigh.price String/null

The highest price that the coin has reached, expressed in the reference currency. Returns null if no all-time high data is available.
data.coins.allTimeHigh.timestamp Number/null

An Epoch timestamp in seconds when the coin reached its highest price. Returns null if no all-time high data is available.
data.coins.coinrankingUrl String

Where to find the coin on coinranking.com
data.coins.contractAddresses Object[]

List of contract addresses for this coin. The format is blockchain/contractAddress. A single coin can be minted on multiple blockchains. For example, Tether (USDT) is available on Ethereum (ethereum/0xda...) Bitcoin Cash (bitcoin-cash/9fc...) and seven other blockchains.

data.coins.isWrappedTrustless Boolean

Indicates whether this coin is a wrapped version of another asset where the wrapping relationship is enforced by smart contracts without requiring trust in a third party.
data.coins.wrappedTo String/null

UUID of the coin that this coin is wrapped to. Returns null when this coin is not a wrapped version of another asset.
pagination Object

Pagination information. See Pagination for more details.
pagination.limit Number

The number of results per page
pagination.hasNextPage Boolean

Whether there are more results available after the current page
pagination.hasPreviousPage Boolean

Whether there are results available before the current page
pagination.nextCursor String/null

Cursor to use for the next page, or null if there are no more results
pagination.previousCursor String/null

Cursor to use for the previous page, or null if on the first page

Error response

json
HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}

Error responses

Previous

Introduction

 Next

Trending coins

On this page