Crypto Historical Data

An effective actor designed to retrieve historical cryptocurrency price & volume data, allowing for customization of time periods and currency choices.

Features

• Historical price data for any cryptocurrency listed on CoinGecko
• Multiple timeframe options from 24 hours to max historical data
• Custom date range support
• Multiple currency conversion options
• Formatted price outputs with timestamps
• Human-readable date formats

Example Input

{
    "coin": "bitcoin",
    "currency": "usd",
    "timeframe": "Custom", // Choose from ["24_hours", "7_days", "30_days", "90_days", "365_days", "max", "custom"]
    "from_timestamp": "2025-02-01", // Required if timeframe is "custom". Format: "YYYY-MM-DD"
    "to_timestamp": "2025-02-15" // Required if timeframe is "custom". Format: "YYYY-MM-DD"
}

Example Output

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

Available currencies

Fiat Currencies:  
- AED // United Arab Emirates Dirham  
- ARS // Argentine Peso  
- AUD // Australian Dollar  
- BDT // Bangladeshi Taka  
- BHD // Bahraini Dinar  
- BMD // Bermudian Dollar  
- BRL // Brazilian Real  
- CAD // Canadian Dollar  
- CHF // Swiss Franc  
- CLP // Chilean Peso  
- CNY // Chinese Yuan  
- CZK // Czech Koruna  
- DKK // Danish Krone  
- EUR // Euro  
- GBP // British Pound Sterling  
- GEL // Georgian Lari  
- HKD // Hong Kong Dollar  
- HUF // Hungarian Forint  
- IDR // Indonesian Rupiah  
- ILS // Israeli New Shekel  
- INR // Indian Rupee  
- JPY // Japanese Yen  
- KRW // South Korean Won  
- KWD // Kuwaiti Dinar  
- LKR // Sri Lankan Rupee  
- MMK // Myanmar Kyat  
- MXN // Mexican Peso  
- MYR // Malaysian Ringgit  
- NGN // Nigerian Naira  
- NOK // Norwegian Krone  
- NZD // New Zealand Dollar  
- PHP // Philippine Peso  
- PKR // Pakistani Rupee  
- PLN // Polish Złoty  
- RUB // Russian Ruble  
- SAR // Saudi Riyal  
- SEK // Swedish Krona  
- SGD // Singapore Dollar  
- THB // Thai Baht  
- TRY // Turkish Lira  
- TWD // New Taiwan Dollar  
- UAH // Ukrainian Hryvnia  
- USD // United States Dollar  
- VEF // Venezuelan Bolívar  
- VND // Vietnamese Đồng  
- ZAR // South African Rand  
- XDR // IMF Special Drawing Rights  
- XAG // Silver (Ounce)  
- XAU // Gold (Ounce)  

Cryptocurrencies:  
- BTC // Bitcoin  
- ETH // Ethereum  
- LTC // Litecoin  
- BCH // Bitcoin Cash  
- BNB // Binance Coin  
- EOS // EOS  
- XRP // Ripple  
- XLM // Stellar Lumens  
- LINK // Chainlink  
- DOT // Polkadot  
- YFI // Yearn.finance  
- BITS // Bitcoin Bits  
- SATS // Satoshis

Limitations

• Custom timeframes must be valid dates
• Historical data granularity varies by timeframe
• Some minor cryptocurrencies might have limited data

Error Handling

The actor includes comprehensive error handling for:

• Invalid input parameters
• Incorrect date formats
• Missing required fields

Error messages are detailed and actionable, helping you quickly identify and resolve issues.

Support

For issues, feature requests, or questions about this actor, please create an issue in the repository.