Currencies

Top Gainers & Losers

Description

Returns the top coins by price movement over the selected period.

Note: Default filters apply: minMarketCap=500000, minVolume24h=1000000.

Tip: Toggle between Gainers and Losers via group (default gainers).

Access

  • Available from: Basic
  • Cost: 1 credit per request
get/v3/currencies/gainers-losers

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/currencies/gainers-losers
  • Auth: API key in header X-Api-Key

Query parameters

period'24h' | '7d' | '30d'

Period over which coins are ranked by price movement.

group'gainers' | 'losers'

gainers returns the biggest risers, losers the biggest fallers.

categoryIdnumber

Filter by category id. See: GET /v3/currencies/categories.

minMarketCapnumber

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

maxMarketCapnumber

Maximum market cap filter, USD.

minVolume24hnumber

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

maxVolume24hnumber

Maximum 24h volume filter, USD.

Response

Example response

{
  "data": [
    {
      "category": {
        "id": 54,
        "name": "DeFi",
        "slug": "defi"
      },
      "id": 1,
      "imageUrl": "https://images.cryptorank.io/coins/150x150.bitcoin1524754012028.png",
      "marketCap": "1280000000000",
      "name": "Bitcoin",
      "price": "65000.5",
      "pricePercentChange": 5.42,
      "rank": 1,
      "slug": "bitcoin",
      "symbol": "BTC",
      "volume24h": "32000000000"
    }
  ],
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.