Crypto Overview Data (Investing.com) - Actor Documentation ## Overview The Crypto Overview Data (Investing.com) Actor is a powerful web scraping tool that fetches comprehensive cryptocurrency market data from Investing.com. This Actor provides real-time information about the top cryptocurrencies, including prices, market capitalization, trading volumes, and percentage changes. ## What does this Actor do? This Actor retrieves cryptocurrency overview information and provides: - Real-time cryptocurrency data for the top cryptocurrencies by market cap - Comprehensive market metrics including price, market cap, volume, and supply data - Performance indicators such as 24-hour and 7-day percentage changes - Paginated results for efficient data retrieval - Structured JSON output ready for analysis and integration ## Key Features ### 📊 Comprehensive Data Points Each cryptocurrency entry includes: - Basic Information: Name, symbol, rank - Price Data: Current price in USD - Market Metrics: Market cap, circulating supply, total supply, max supply - Volume Data: 24-hour trading volume and volume percentage - Performance: 24-hour and 7-day percentage changes ### 🔄 Pagination Support - Retrieve data in manageable chunks - Configurable items per page (1-1000) - Page-based navigation for large datasets ### 📈 Real-time Data - Fresh cryptocurrency market data - Up-to-date pricing and market information - Current market rankings ## Input Configuration The Actor accepts the following input parameters: ### Required Parameters None - all parameters have default values for immediate use. ### Optional Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | page_number | integer | 1 | The page number to retrieve (starting from 1) | | items_per_page | integer | 100 | Number of cryptocurrencies per page (1-1000) | ### Input Schema Example json { "page_number": 1, "items_per_page": 20 } ## Output Format The Actor outputs structured JSON data for each cryptocurrency. Here's the complete data structure: ### Individual Cryptocurrency Record json { "24hChangePct": 0.0164931218, "24hVolume": 50342.71347328709, "7dChangePct": 0.0313086698, "circulatingSupply": 19.883384, "currency": "USD", "marketCap": 2137665.551608184, "maxSupply": 21, "name": "Bitcoin", "price": 107207.9, "rank": 1, "symbol": "BTC", "totalSupply": 19.883384, "volumePct": 0.4603 } ### Field Descriptions | Field | Type | Description | |-------|------|-------------| | 24hChangePct | number | 24-hour price change percentage (decimal format) | | 24hVolume | number | 24-hour trading volume in USD | | 7dChangePct | number | 7-day price change percentage (decimal format) | | circulatingSupply | number | Current circulating supply of the cryptocurrency | | currency | string | Base currency (always "USD") | | marketCap | number | Market capitalization in USD | | maxSupply | number | Maximum possible supply (0 if unlimited) | | name | string | Full name of the cryptocurrency | | price | number | Current price in USD | | rank | integer | Market cap ranking | | symbol | string | Trading symbol/ticker | | totalSupply | number | Total supply of the cryptocurrency | | volumePct | number | Volume percentage relative to total market | ### Summary Information The Actor also provides a summary object accessible via Actor.getValue("overview_summary"): json { "total_cryptocurrencies": 20, "page": 1, "per_page": 20, "has_next_page": true, "currency": "USD", "retrieved_at": "2025-01-15T10:30:00.000Z" } ## Usage Examples ### Example 1: Get Top 50 Cryptocurrencies json { "page_number": 1, "items_per_page": 50 } ### Example 2: Paginate Through Results json { "page_number": 2, "items_per_page": 100 } ### Example 3: Get Specific Page Range json { "page_number": 5, "items_per_page": 25 } ## Data Processing The Actor intelligently handles different data formats: 1. Paginated Data: Processes paginated responses with metadata 2. List Data: Handles simple array responses 3. DataFrame Data: Converts pandas DataFrames to records 4. Single Records: Manages individual cryptocurrency data ## Error Handling The Actor includes comprehensive error handling for: - Validation Errors: Invalid input parameters - IO Errors: Network or file system issues - Runtime Errors: Execution problems - Connection Errors: Network connectivity issues - Unexpected Errors: Any other unforeseen issues All errors are logged with detailed information and cause the Actor to fail gracefully. ## Monitoring and Logging The Actor provides detailed logging information: - Request parameters - Retrieval progress - Data processing status - Error details - Success confirmations ## Rate Limiting and Best Practices ### Recommendations: - Use reasonable items_per_page values (50-200 for most use cases) - Implement delays between multiple Actor runs - Monitor your usage to stay within Apify platform limits - Cache results when appropriate for your use case ### Performance Tips: - Smaller page sizes result in faster individual requests - Larger page sizes are more efficient for bulk data collection - Consider your downstream processing capabilities when choosing page sizes ## Integration Examples ### Python Integration python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") # Run the Actor run = client.actor("your-actor-id").call(run_input={ "page_number": 1, "items_per_page": 100 }) # Fetch results for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{item['name']}: ${item['price']}") ### JavaScript Integration javascript import { ApifyApi } from 'apify-client'; const client = new ApifyApi({ token: 'YOUR_API_TOKEN', }); const run = await client.actor('the-actor-id').call({ page_number: 1, items_per_page: 50 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(crypto => { console.log(`${crypto.name}: $${crypto.price}`); }); ## Use Cases ### Financial Analysis - Portfolio tracking and analysis - Market research and trend analysis - Price monitoring and alerts - Historical data collection ### Data Science - Machine learning model training - Cryptocurrency market prediction - Statistical analysis - Data visualization projects ### Trading Applications - Automated trading systems - Market screening tools - Risk management systems - Performance tracking ### Research and Education - Academic research projects - Educational dashboards - Market analysis tutorials - Cryptocurrency education platforms ## Troubleshooting ### Common Issues Issue: No data returned - Solution: Check if the page number is valid and within range Issue: Validation errors - Solution: Ensure items_per_page is between 1 and 1000, and page_number is a positive integer Issue: Connection errors - Solution: The source website might be temporarily unavailable; try running the Actor again later ### Support For technical support and questions: - Check the Actor's run logs for detailed error information - Verify your input parameters match the schema - Ensure you have sufficient Apify credits for the operation ## Data Freshness The cryptocurrency data is fetched in real-time from Investing.com, ensuring you receive the most current market information available. Data includes: - Live pricing information - Real-time market cap calculations - Current trading volumes - Up-to-date percentage changes ## 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. ---