Pricing

Rating

Developer

Actor stats

Categories

Share

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 =newApifyClient({
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.