Crypto Historical Data (Investing.com) Actor Documentation ## Overview The Crypto Historical Data (Investing.com) Actor is a powerful tool that fetches historical cryptocurrency price data from Investing.com. This Actor allows you to retrieve comprehensive historical data for any cryptocurrency, including open, high, low, close prices, trading volume, and timestamps for specified date ranges. ## Features - ✅ Multiple Cryptocurrencies: Support for all major cryptocurrencies (BTC, ETH, ADA, etc.) - ✅ Flexible Date Ranges: Retrieve data for any custom date range - ✅ Multiple Intervals: Daily, Weekly, and Monthly data intervals - ✅ Data Ordering: Ascending or descending chronological order - ✅ Comprehensive Data: OHLCV (Open, High, Low, Close, Volume) data with timestamps - ✅ JSON Output: Clean, structured JSON format for easy integration - ✅ Error Handling: Robust validation and error reporting ## Input Parameters ### Required Parameters | Parameter | Type | Description | Example | |-----------|------|-------------|---------| | symbol | String | Cryptocurrency symbol | "BTC", "ETH", "ADA" | | from_date | String | Start date in dd/mm/yyyy format | "01/01/2024" | | to_date | String | End date in dd/mm/yyyy format | "27/04/2024" | ### Optional Parameters | Parameter | Type | Default | Options | Description | |-----------|------|---------|---------|-------------| | order | String | "ascending" | "ascending", "descending" | Order of data by date | | interval | String | "Daily" | "Daily", "Weekly", "Monthly" | Data interval frequency | ## Input Schema Example json { "symbol": "BTC", "from_date": "01/01/2024", "to_date": "27/04/2024", "order": "ascending", "interval": "Daily" } ## Output Format The Actor returns a comprehensive JSON object with the following structure: ### Main Response Object json { "symbol": "BTC", "name": "Bitcoin", "data_points": 118, "date_range": "01/01/2024 to 27/04/2024", "interval": "Daily", "historical_data": [...] } ### Historical Data Points Each data point in the historical_data array contains: | Field | Type | Description | |-------|------|-------------| | date | String | Date in YYYY-MM-DD format | | open | Number | Opening price in USD | | high | Number | Highest price of the day in USD | | low | Number | Lowest price of the day in USD | | close | Number | Closing price in USD | | volume | Number | Trading volume | | currency | String | Currency denomination (USD) | ### Sample Data Point json { "date": "01/01/2024", "open": 42272.5, "high": 44187.0, "low": 42196.7, "close": 44183.4, "volume": 36302, "currency": "USD" } ## Usage Examples ### Basic Usage javascript // Minimal configuration for Bitcoin data { "symbol": "BTC", "from_date": "01/01/2024", "to_date": "31/01/2024" } ### Advanced Usage javascript // Ethereum weekly data in descending order { "symbol": "ETH", "from_date": "01/01/2024", "to_date": "31/12/2024", "order": "descending", "interval": "Weekly" } ### Multiple Cryptocurrencies To fetch data for multiple cryptocurrencies, run the Actor multiple times with different symbols: javascript // Run 1: Bitcoin { "symbol": "BTC", "from_date": "01/01/2024", "to_date": "31/01/2024" } // Run 2: Ethereum { "symbol": "ETH", "from_date": "01/01/2024", "to_date": "31/01/2024" } // Run 3: Cardano { "symbol": "ADA", "from_date": "01/01/2024", "to_date": "31/01/2024" } ## Supported Cryptocurrencies The Actor supports all major cryptocurrencies available on Investing.com, including but not limited to: - BTC - Bitcoin - ETH - Ethereum - ADA - Cardano - XRP - Ripple - DOT - Polkadot - LINK - Chainlink - LTC - Litecoin - BCH - Bitcoin Cash - XLM - Stellar - DOGE - Dogecoin ## Error Handling The Actor includes comprehensive error handling for common scenarios: ### Validation Errors - Missing required parameters - Invalid date formats - Invalid cryptocurrency symbols ### Runtime Errors - Network connectivity issues - Data source unavailability - Invalid date ranges ### Example Error Response If an error occurs, the Actor will log detailed error information and terminate with a descriptive error message. ## Best Practices ### Date Range Selection - Use reasonable date ranges to avoid timeouts - For large datasets, consider breaking into smaller chunks - Be aware that very old data may not be available for all cryptocurrencies ### Performance Optimization - Use appropriate intervals (Daily for short periods, Weekly/Monthly for longer periods) - Consider the data volume when setting date ranges - Monitor Actor runtime for large requests ### Data Integration - Parse the JSON response to extract specific data points - Use the data_points field to validate expected data volume - Handle edge cases where data might be missing for certain dates ## Rate Limits and Considerations - The Actor respects Investing.com's rate limits - Large date ranges may take longer to process - Consider the Actor's timeout settings for extensive data requests ## Data Storage The Actor stores retrieved data in the Apify dataset and also sets a summary value that can be accessed via the Actor's storage API. ### Accessing Data javascript // From dataset const dataset = await Actor.openDataset(); const data = await dataset.getData(); // From key-value store const summary = await Actor.getValue('summary'); ## Troubleshooting ### Common Issues 1. Invalid Symbol Error - Ensure the cryptocurrency symbol is correct and supported - Check Investing.com for the exact symbol format 2. Date Format Error - Use DD/MM/YYYY format exactly - Ensure dates are valid and to_date is after from_date 3. No Data Returned - Verify the cryptocurrency was trading during the specified period - Check if the date range includes weekends/holidays for daily data 4. Timeout Issues - Reduce the date range for large requests - Use Weekly or Monthly intervals for longer periods ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Apify Platform: You can also contact us directly through this platform. ---