Skip to main content
GET
/
v3
/
currencies
/
gainers-losers
Top Gainers & Losers
curl --request GET \
  --url https://api.cryptorank.io/v3/currencies/gainers-losers \
  --header 'X-Api-Key: <api-key>'
{
  "data": [
    {
      "id": 1,
      "rank": 1,
      "slug": "bitcoin",
      "symbol": "BTC",
      "name": "Bitcoin",
      "imageUrl": "https://images.cryptorank.io/coins/150x150.bitcoin1524754012028.png",
      "category": {
        "id": 7,
        "slug": "smart-contracts",
        "name": "Smart Contracts"
      },
      "price": "65000.5",
      "marketCap": "1280000000000",
      "pricePercentChange": 5.42,
      "volume24h": "32000000000"
    }
  ],
  "status": {
    "usedCredits": 1,
    "timestamp": 1780000000000
  }
}
Default filters apply: minMarketCap=500000, minVolume24h=1000000.
Toggle between Gainers and Losers via group (default gainers).

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
period
enum<string>
default:24h

Period over which coins are ranked by price movement.

Available options:
24h,
7d,
30d
​
group
enum<string>
default:gainers

gainers returns the biggest risers, losers the biggest fallers.

Available options:
gainers,
losers
​
categoryId
number

Filter by category id.

​
minMarketCap
number
default:500000

Minimum market cap filter, USD. Pass 0 to disable.

Required range: x >= 0
​
maxMarketCap
number

Maximum market cap filter, USD.

Required range: x >= 0
​
minVolume24h
number
default:1000000

Minimum 24h volume filter, USD. Pass 0 to disable.

Required range: x >= 0
​
maxVolume24h
number

Maximum 24h volume filter, USD.

Required range: x >= 0

Response

​
data
object[]
required
​
status
object
required