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

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

Example Output

1[
2    {
3        "price": 45000.75555555,
4        "price_formatted": "$45,000.75",
5        "date": "2024-02-11 15:30:00",
6        "timestamp": 1707665400000,
7        "volume": 38921302935.18796
8    }
9]

Available currencies

1Fiat Currencies:  
2- AED // United Arab Emirates Dirham  
3- ARS // Argentine Peso  
4- AUD // Australian Dollar  
5- BDT // Bangladeshi Taka  
6- BHD // Bahraini Dinar  
7- BMD // Bermudian Dollar  
8- BRL // Brazilian Real  
9- CAD // Canadian Dollar  
10- CHF // Swiss Franc  
11- CLP // Chilean Peso  
12- CNY // Chinese Yuan  
13- CZK // Czech Koruna  
14- DKK // Danish Krone  
15- EUR // Euro  
16- GBP // British Pound Sterling  
17- GEL // Georgian Lari  
18- HKD // Hong Kong Dollar  
19- HUF // Hungarian Forint  
20- IDR // Indonesian Rupiah  
21- ILS // Israeli New Shekel  
22- INR // Indian Rupee  
23- JPY // Japanese Yen  
24- KRW // South Korean Won  
25- KWD // Kuwaiti Dinar  
26- LKR // Sri Lankan Rupee  
27- MMK // Myanmar Kyat  
28- MXN // Mexican Peso  
29- MYR // Malaysian Ringgit  
30- NGN // Nigerian Naira  
31- NOK // Norwegian Krone  
32- NZD // New Zealand Dollar  
33- PHP // Philippine Peso  
34- PKR // Pakistani Rupee  
35- PLN // Polish Złoty  
36- RUB // Russian Ruble  
37- SAR // Saudi Riyal  
38- SEK // Swedish Krona  
39- SGD // Singapore Dollar  
40- THB // Thai Baht  
41- TRY // Turkish Lira  
42- TWD // New Taiwan Dollar  
43- UAH // Ukrainian Hryvnia  
44- USD // United States Dollar  
45- VEF // Venezuelan Bolívar  
46- VND // Vietnamese Đồng  
47- ZAR // South African Rand  
48- XDR // IMF Special Drawing Rights  
49- XAG // Silver (Ounce)  
50- XAU // Gold (Ounce)  
51
52Cryptocurrencies:  
53- BTC // Bitcoin  
54- ETH // Ethereum  
55- LTC // Litecoin  
56- BCH // Bitcoin Cash  
57- BNB // Binance Coin  
58- EOS // EOS  
59- XRP // Ripple  
60- XLM // Stellar Lumens  
61- LINK // Chainlink  
62- DOT // Polkadot  
63- YFI // Yearn.finance  
64- BITS // Bitcoin Bits  
65- 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.