Crypto Information Data (Investing.com) - Apify Actor Documentation ## Overview The Crypto Information Data (Investing.com) Actor is a powerful tool designed to fetch comprehensive cryptocurrency information from Investing.com. This Actor provides real-time and detailed data about any cryptocurrency, including market capitalization, trading volume, price information, supply details, and much more. ## Key Features - Real-time Data: Fetches up-to-date cryptocurrency information directly from Investing.com - Comprehensive Information: Provides detailed market data including price, volume, market cap, supply metrics, and percentage changes - Easy Integration: Simple input/output format perfect for data analysis and automation workflows - Reliable Performance: Built with robust error handling and logging for production use - Structured Output: Returns well-formatted JSON data ready for further processing ## Use Cases - Portfolio Tracking: Monitor your cryptocurrency investments with real-time data - Market Analysis: Gather data for technical and fundamental analysis - Research & Development: Collect cryptocurrency data for academic or business research - Trading Bots: Integrate with automated trading systems - Dashboard Creation: Feed data into custom dashboards and visualization tools - Data Pipeline: Part of larger data collection and processing workflows ## Input Configuration The Actor accepts a simple JSON input with the following parameters: ### Required Parameters - symbol (string, required): The cryptocurrency symbol to retrieve data for - Example: "BTC" for Bitcoin, "ETH" for Ethereum, "ADA" for Cardano - Must be a valid cryptocurrency symbol recognized by Investing.com - Minimum length: 1 character ### Input Schema Example json { "symbol": "BTC" } ### Supported Cryptocurrencies The Actor supports all major cryptocurrencies available on Investing.com, including but not limited to: - Bitcoin (BTC) - Ethereum (ETH) - Binance Coin (BNB) - Cardano (ADA) - Solana (SOL) - XRP (XRP) - Dogecoin (DOGE) - Polygon (MATIC) - And many more... ## Output Format The Actor returns comprehensive cryptocurrency data in JSON format. The output includes both basic information and detailed market metrics. ### Output Structure json { "instrumentId": "1057391", "isin": "", "commodityName": "Bitcoin", "contract": {}, "details": { "cryptoId": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "currencyId": "189", "related_pair_ID": "1057391", "relatedIndices": "1057388,1062795", "priceUsd": "107273", "priceBtc": "1", "volume": 49458249164.03101, "marketCapUsd": 2132945813720.2468, "totalVolume": "45.01", "changePercent": "1.58", "percentChange7D": 2.71, "availableSupply": 19883312, "maxSupply": 21000000, "isActive": "Yes", "lastUpdated": "2025-06-25 15:19:00", "relatedPairs": "945629,1115746,1035793,1057581,1129220", "rank": "1" }, "tickerSymbol": "BTC/USD", "exchange": "Investing.com Index", "exchangeSymbol": "Investing.com", "ask": 0, "bid": 0, "relatives": { "relatives": [ { "id": "1055949", "flag": "US", "name": "Bitcoin Futures CME", "symbol": "BMC", "link": "/crypto/bitcoin/bitcoin-futures", "smlLinks": { "overview": "/crypto/bitcoin/bitcoin-futures", "advanced-chart": "/crypto/bitcoin/bitcoin-futures-advanced-chart", "historical-data": "/crypto/bitcoin/bitcoin-futures-historical-data" } } ] } } ### Key Data Points Explained #### Basic Information - instrumentId: Unique identifier for the cryptocurrency on Investing.com - commodityName: Full name of the cryptocurrency - tickerSymbol: Trading pair symbol (e.g., BTC/USD) - exchange: Exchange or index source - exchangeSymbol: Exchange identifier #### Market Details - priceUsd: Current price in USD - priceBtc: Price in Bitcoin (for non-Bitcoin cryptocurrencies) - volume: 24-hour trading volume - marketCapUsd: Market capitalization in USD - changePercent: 24-hour percentage change - percentChange7D: 7-day percentage change - rank: Market cap ranking #### Supply Information - availableSupply: Current circulating supply - maxSupply: Maximum possible supply - totalVolume: Total trading volume #### Additional Data - lastUpdated: Timestamp of last data update - isActive: Whether the cryptocurrency is actively traded - relatedPairs: Related trading pairs - relatives: Related instruments and futures contracts ## Usage Examples ### Basic Usage json { "symbol": "BTC" } ### Multiple Runs for Different Cryptocurrencies Run the Actor multiple times with different symbols: 1. Bitcoin: {"symbol": "BTC"} 2. Ethereum: {"symbol": "ETH"} 3. Cardano: {"symbol": "ADA"} ### Integration with Other Tools The structured JSON output makes it easy to integrate with: - Data Analysis Tools: Import into pandas, R, or Excel - Databases: Store in MongoDB, PostgreSQL, or other databases - APIs: Use as part of REST API responses - Visualization Tools: Feed into charts and dashboards - Trading Systems: Use for automated trading decisions ## Error Handling The Actor includes comprehensive error handling for common scenarios: ### Input Validation Errors - Missing or empty symbol parameter - Invalid symbol format - Non-string symbol values ### Network and Data Errors - Connection timeouts - Invalid cryptocurrency symbols - Service unavailability - Rate limiting ### Error Response Format When errors occur, the Actor will fail with descriptive error messages: Validation error: Missing "symbol" attribute in input! Please provide a crypto symbol (e.g., "BTC") ## Performance and Limits - Runtime: Typically completes in 5-15 seconds - Rate Limits: Respects Investing.com's rate limiting - Memory Usage: Minimal memory footprint - Concurrent Runs: Supports multiple concurrent executions ## Best Practices ### Symbol Format - Use uppercase symbols (e.g., "BTC" not "btc") - Use standard cryptocurrency symbols - Verify symbol existence on Investing.com before running ### Data Freshness - Data is updated in real-time from Investing.com - Check the lastUpdated field for data timestamp - Re-run the Actor for the most current data For current pricing information, please refer to Apify's pricing page. ## Support and Updates ### Getting Help - Check the Actor's run logs for detailed error information - Review input validation requirements - Contact support through Apify's support channels ### Version Updates - The Actor is regularly updated to maintain compatibility with Investing.com - Monitor the Actor's changelog for updates and improvements - Update your integrations when new features are added ## Technical Details ### Dependencies - Apify SDK: Core framework for Actor development - Custom Utilities: Specialized functions for cryptocurrency data extraction - JSON Processing: Built-in JSON parsing and validation ### Data Source - Primary Source: Investing.com - Update Frequency: Real-time - Data Accuracy: High-quality financial data from a trusted source ### Output Guarantees - All successful runs return valid JSON - Consistent data structure across all cryptocurrency symbols - Error states are clearly communicated ## Sample Integrations ### Python Integration python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") # Run the Actor run = client.actor("THE_ACTOR_ID").call(run_input={"symbol": "BTC"}) # Fetch results for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"Bitcoin price: ${item['details']['priceUsd']}") print(f"Market cap: ${item['details']['marketCapUsd']}") ### JavaScript Integration javascript const ApifyClient = require('apify-client'); const client = new ApifyClient({ token: 'YOUR_API_TOKEN', }); const run = await client.actor('THE_ACTOR_ID').call({ symbol: 'ETH' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.log(`Ethereum price: $${item.details.priceUsd}`); }); ## 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. ---