Crypto Losers Tracker

Overview

An Apify actor that fetches and tracks the worst-performing cryptocurrencies by price from CoinMarketCap. It provides detailed performance metrics over selectable timeframes, useful for market analysis, trading bots, or data feeds.

Key Features

• Track Losers: Fetches coins with the largest price declines.
• Flexible Timeframes: Analyze performance over 1 hour, 24 hours, 7 days, or 30 days.
• Customizable Range: Set a specific ranking range (e.g., top 50) or retrieve all coins.
• Detailed Metrics: Includes price changes, market capitalization, and 24-hour volume.
• Sortable Results: Order results in ascending or descending order.
• Developer-Friendly: Output includes both ISO timestamps and Unix timestamps for easy integration.

How to Use

Configure the actor run with an input object. The main parameters are:

• rankRange: The number of coins to return (e.g., 10 for the top 10 losers). Use 0 to fetch all available coins (within the 60-500 limit).
• timeframe: The performance period. Choose from: "1h", "24h", "7d", "30d".
• order_by: The sort order for the results. Use "Desc" (largest loser first) or "Asc".

Example Input

To get the top 100 losers in the last 24 hours:

{
  "rankRange": 100,
  "timeframe": "24h",
  "order_by": "Desc"
}

Input & Output

Input Schema:
The actor accepts a JSON object with the parameters described in the "How to Use" section.

Output:
The actor returns an array of cryptocurrency objects. Each object contains comprehensive data, as shown in this example:

[
  {
    "id": "1",
    "name": "Bitcoin",
    "symbol": "BTC",
    "slug": "bitcoin",
    "rank": 1,
    "status": "active",
    "marketCap": 859259631.10,
    "selfReportedMarketCap": 1326048458.8459216,
    "price": 45000.75,
    "priceChange1h": 1.2,
    "priceChange24h": -2.5,
    "priceChange7d": 5.8,
    "priceChange30d": 10.4,
    "volume24h": 25000000000,
    "lastUpdate": "2024-02-12T15:30:00.000Z",
    "lastUpdateTimestamp": 1707665400
  }
]

Limitations & Error Handling

• The rankRange is limited to between 60 and 500 coins (use 0 for the maximum in this range).
• Only the four specified timeframe options are available.
• The selfReportedMarketCap field may be null for some coins.
• The actor includes error handling for invalid inputs (rank ranges, timeframes, sort orders) and malformed data, providing clear exception messages to help resolve issues.

Support

For bugs, feature requests, or questions, please create an issue in the actor's repository on the Apify platform.