List of trending coins

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

Be aware that by default the list includes coins with tier 1, 2 and 3. Users can choose which tiers to include in the list and rank coins based on their selected filters.

Trending coins are ranked dynamically based on user engagement and popularity. By default, the API returns the top 50 trending coins along with the price of each trending coin in USD. 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.

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

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/trending?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/trending?timePeriod=7d
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/trending?tiers[]=1&tiers[]=2
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: 1-5000

Example:
...coins/trending?limit=50
offset (optional) Number

Offset. Used for pagination.

Default value: 0

Example:
...coins/trending?offset=50

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "coins": [
      {
        "uuid": "x1naMqhnQ",
        "symbol": "AI16Z",
        "name": "ai16z",
        "color": "#b56d47",
        "iconUrl": "https://cdn.coinranking.com/d1Cq1QRia/ai16z.png",
        "marketCap": "216162596",
        "price": "0.19651159766076215",
        "listedAt": 1730096051,
        "tier": 1,
        "change": "13.93",
        "rank": 1,
        "sparkline": [
          "0.1734302093738471",
          "0.1722441249843424",
          "0.17206841234970932",
          ...
        ],
        "lowVolume": false,
        "coinrankingUrl": "https://coinranking.com/coin/x1naMqhnQ+ai16z-ai16z",
        "24hVolume": "55044627",
        "btcPrice": "0.000002290513667438",
        "contractAddresses": [
          "solana/HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC"
        ]
      },
      {
        "uuid": "VDSp0_jlF",
        "symbol": "FARTCOIN",
        "name": "Fartcoin",
        "color": "#141414",
        "iconUrl": "https://cdn.coinranking.com/mWrHIRttj/fart.png",
        "marketCap": "384211556",
        "price": "0.38421222643273306",
        "listedAt": 1729808507,
        "tier": 1,
        "change": "26.52",
        "rank": 2,
        "sparkline": [
          "0.30212807097709193",
          "0.3012665015434585",
          "0.302866142569032",
          ...
        ],
        "lowVolume": false,
        "coinrankingUrl": "https://coinranking.com/coin/VDSp0_jlF+fartcoin-fartcoin",
        "24hVolume": "104234071",
        "btcPrice": "0.000004478327825516",
        "contractAddresses": [
          "solana/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
        ]
      },
      {
        "uuid": "54I_A3MXKhHjZ",
        "symbol": "PI",
        "name": "Pi Network Coin",
        "color": "#402867",
        "iconUrl": "https://cdn.coinranking.com/dEJWskWni/pi-network-logo.png",
        "marketCap": "7368941912",
        "price": "1.1681250256177722",
        "listedAt": 1494288000,
        "tier": 1,
        "change": "1.01",
        "rank": 3,
        "sparkline": [
          "1.1559768754179904",
          "1.146620130952483",
          "1.141923934383675",
          ...
        ],
        "lowVolume": false,
        "coinrankingUrl": "https://coinranking.com/coin/54I_A3MXKhHjZ+pinetworkcoin-pi",
        "24hVolume": "408118286",
        "btcPrice": "0.000013615513630255",
        "contractAddresses": []
      }
    ]
  }
}

Response fields

Property Description
status String

Status of the request

Allowed values:
success
data Object
data.coins Object[]

List of trending 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.marketCap String

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

Price of the coin
data.coins.listedAt Number/null

Epoch timestamp of when we started listing the coin.
data.coins.tier String

Tier of the coin. 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.coin.lowVolume Boolean

If the coin is not much traded on listed exchanges it is marked as having a low volume. The threshold is currently set at the equivalent of 500.000 US Dollar in 24 hours
data.coins.coinrankingUrl String

Where to find the coin on coinranking.com
data.coins.24hVolume String

24h trade volume
data.coins.btcPrice String

Price of the coin expressed in Bitcoin
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.

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

List of coins

 Next

Coin details

On this page