crypto-pricehistory-api

An Apify actor that fetches historical cryptocurrency price and volume data from CoinGecko. You can specify the coin, the currency for price conversion, and the timeframe for the data.

Key Features

• Fetches historical price and volume data for any cryptocurrency listed on CoinGecko.
• Supports multiple timeframes: 24 hours, 7 days, 30 days, 90 days, 365 days, max available, or a custom date range.
• Converts prices into dozens of fiat currencies, precious metals, or other cryptocurrencies.
• Returns data with timestamps, human-readable dates, and formatted price strings.
• Includes comprehensive error handling for invalid inputs.

How to Use

Configure the actor run with an input object specifying your query parameters.

Input

The main input fields are:

• coin (string, required): The cryptocurrency ID (e.g., "bitcoin", "ethereum").
• currency (string, required): The target currency for price conversion (e.g., "usd", "eur", "btc").
• timeframe (string, required): The data range. Options: "24_hours", "7_days", "30_days", "90_days", "365_days", "max", or "custom".
• from_timestamp (string, required if timeframe is "custom"): Start date in "YYYY-MM-DD" format.
• to_timestamp (string, required if timeframe is "custom"): End date in "YYYY-MM-DD" format.

{
  "coin": "bitcoin",
  "currency": "usd",
  "timeframe": "custom",
  "from_timestamp": "2025-02-01",
  "to_timestamp": "2025-02-15"
}

Output

The actor returns an array of objects, each representing a data point. Example:

[
  {
    "price": 45000.75555555,
    "price_formatted": "$45,000.75",
    "date": "2024-02-11 15:30:00",
    "timestamp": 1707665400000,
    "volume": 38921302935.18796
  }
]

Available Currencies

You can convert to numerous fiat currencies (like USD, EUR, JPY), precious metals (XAU, XAG), and other cryptocurrencies (BTC, ETH). See the full list in the original README for all supported codes.

Limitations & Notes

• Custom timeframes require valid dates in the correct format.
• The granularity of historical data (hourly, daily) depends on the selected timeframe.
• Some less popular cryptocurrencies may have limited historical data available.

Support

For issues or feature requests, please create an issue in the actor's repository.