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

{
  "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

{
  "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

{
  "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

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

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.

---