Top Gainers & Losers

Changed on

To query the top 30 coins with largest price gain and loss by a specific time duration

get/coins/top_gainers_losers

Request

Query parameters

vs_currencystring required

Target currency of coins. *refers to /simple/supported_vs_currencies

duration'1h' | '24h' | '7d' | '14d' | '30d' | '60d' | '1y'

Filter result by time range. Default: 24h

price_change_percentagestring

Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 60d, 200d, 1y

top_coins'300' | '500' | '1000' | 'all'

Filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap). Default: 1000

Response

Top gainers and losers

Changes

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      api tag Coins removed

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • breaking

      the response's body type changed from array to object for status

    • info

      added the new optional query request parameter price_change_percentage

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status