Cryptocurrency Prices

Fetch real-time cryptocurrency prices and comprehensive market data with this powerful Actor.

Description

This Apify Actor retrieves current cryptocurrency prices, market capitalization, trading volumes, and price movements.

Key features:

• Trending & New: Browse currently trending cryptocurrencies and newly launched coins
• Flexible Currency Support: Get prices in USD, EUR, GBP, JPY, CAD, AUD, INR, or BRL
• Customizable Output: Select specific cryptocurrencies or top rankings by various metrics
• Market Insights: Includes market cap, 24-hour volume, price changes, and historical data
• Price History: Optional 7-day sparkline data for visualization and analysis
• Robust Error Handling: Comprehensive logging and graceful failure management

Use Cases

• Market Analysis: Analyze cryptocurrency price trends and market movements
• Portfolio Tracking: Monitor prices of cryptocurrencies in your investment portfolio
• Data Integration: Integrate real-time crypto data into dashboards and applications
• Research: Collect historical cryptocurrency market data for analysis
• Comparison Tools: Compare prices across different currencies and time periods

Input

The Actor accepts flexible input parameters to customize data collection:

{
  "cryptoIds": [],
  "limit": "50",
  "order": "market_cap_desc",
  "vsCurrency": "usd",
  "sparkline": false,
  "includeMarketCap": true,
  "includeVolume": true,
  "include24hChange": true,
  "timeout": 30
}

Input Parameters

Parameter	Type	Default	Description
cryptoIds	Array	[]	Optional - Specify exact cryptocurrency IDs to fetch (e.g., "bitcoin", "ethereum", "cardano"). If provided, returns only these coins. If empty, fetches top cryptocurrencies based on the Limit parameter.
limit	String	"50"	Custom or preset - Number of cryptocurrencies to fetch when cryptoIds is empty. Choose from presets (10, 25, 50, 100, 250, 500, 1000, 5000) or enter any custom number from 1-5000. Ignored if cryptoIds is specified.
order	String	market_cap_desc	Sort order options: Standard - market_cap_desc, market_cap_asc, volume_desc, volume_asc, id_asc, id_desc; Special - trending (currently trending 🔥), newly_launched (recently added 🚀).
vsCurrency	String	usd	Currency to display all prices in - usd, eur, gbp, jpy, cad, aud, inr, brl. All cryptocurrency data will be converted to this currency.
sparkline	Boolean	false	Include 7-day price history data for visualization.
includeMarketCap	Boolean	true	Include market capitalization data.
includeVolume	Boolean	true	Include 24-hour trading volume data.
include24hChange	Boolean	true	Include 24-hour price change percentage.
timeout	Integer	30	Request timeout in seconds (5-120).

Input Parameter Behavior

Important: The behavior of the Actor depends on how you configure the inputs:

1. Empty cryptoIds (recommended for browsing):

   • Leave cryptoIds empty
   • Set limit to any number from 1-5000 (use presets or enter custom)
   • All data will respect the vsCurrency selection
   • For limits > 250, the Actor automatically makes multiple API requests
   • Example: limit=50 with vsCurrency=eur returns top 50 cryptocurrencies in euros

2. Specified cryptoIds (for specific coins):

   • Provide specific cryptocurrency IDs
   • limit parameter is ignored
   • Returns only the cryptocurrencies you specified
   • Example: cryptoIds=["bitcoin", "ethereum"] returns 2 cryptocurrencies regardless of limit
   • Data is still displayed in the selected vsCurrency

Sorting Options

The order parameter supports multiple sorting strategies:

Standard Sorting (by metrics)

• market_cap_desc - Cryptocurrencies sorted by market cap (highest first) - Default
• market_cap_asc - Cryptocurrencies sorted by market cap (lowest first)
• volume_desc - Sorted by 24-hour trading volume (highest first)
• volume_asc - Sorted by 24-hour trading volume (lowest first)
• id_asc - Sorted alphabetically by name (A to Z)
• id_desc - Sorted alphabetically by name (Z to A)

Special Options

• 🔥 trending - Get currently trending cryptocurrencies in the last 24 hours
• 🚀 newly_launched - Get recently added and newly launched cryptocurrencies

Output

The Actor saves cryptocurrency data to a structured dataset with the following schema:

{
  "id": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "current_price": 45250.50,
  "market_cap": 889632500000,
  "market_cap_rank": 1,
  "total_volume": 28500000000,
  "price_change_percentage_24h": 2.5,
  "circulating_supply": 21000000,
  "total_supply": 21000000,
  "max_supply": 21000000,
  "ath": 69045,
  "atl": 67.81,
  "image": "https://example.com/crypto/bitcoin.png",
  "last_updated": "2024-12-21T10:30:45.000Z",
  "sparkline_7d": [43250, 43800, 44200, 44900, 45100, 45300, 45250]
}

Output Fields

Field	Type	Description
id	String	Unique cryptocurrency identifier
symbol	String	Cryptocurrency ticker symbol
name	String	Full cryptocurrency name
current_price	Number	Current price in selected currency
market_cap	Number	Total market capitalization
market_cap_rank	Integer	Rank by market capitalization
total_volume	Number	24-hour trading volume
price_change_percentage_24h	Number	24-hour price change (%)
circulating_supply	Number	Circulating supply amount
total_supply	Number	Total supply amount
max_supply	Number	Maximum supply (if applicable)
ath	Number	All-time high price
atl	Number	All-time low price
image	String	Cryptocurrency logo image URL
last_updated	String	Last update timestamp (ISO 8601)
sparkline_7d	Array	7-day price history data

Configuration Examples

Example 1: Top 10 Cryptocurrencies by Market Cap (USD)

Fetch the top 10 cryptocurrencies sorted by market capitalization in USD:

{
  "cryptoIds": [],
  "limit": "10",
  "order": "market_cap_desc",
  "vsCurrency": "usd"
}

Example 2: Top 50 Cryptocurrencies in Euro

Get top 50 cryptocurrencies with all available data in EUR:

{
  "cryptoIds": [],
  "limit": "50",
  "order": "market_cap_desc",
  "vsCurrency": "eur",
  "includeMarketCap": true,
  "includeVolume": true,
  "include24hChange": true,
  "sparkline": true
}

Example 3: Specific Cryptocurrencies in GBP

Get detailed data for specific coins (Bitcoin, Ethereum, Cardano) in British Pounds:

{
  "cryptoIds": ["bitcoin", "ethereum", "cardano"],
  "vsCurrency": "gbp",
  "includeMarketCap": true,
  "includeVolume": true,
  "include24hChange": true,
  "sparkline": true
}

Example 4: Top 1000 Cryptocurrencies (Custom Limit)

Fetch a large dataset of 1000 cryptocurrencies by market cap with complete data:

{
  "cryptoIds": [],
  "limit": "1000",
  "order": "market_cap_desc",
  "vsCurrency": "usd",
  "includeMarketCap": true,
  "includeVolume": true,
  "include24hChange": true,
  "sparkline": false
}

Example 5: Top 25 Cryptocurrencies with Minimal Data

Fetch minimal data for quick monitoring without market details:

{
  "cryptoIds": [],
  "limit": "25",
  "includeMarketCap": false,
  "includeVolume": false,
  "sparkline": false
}

Example 6: Trending Cryptocurrencies in Japanese Yen

Get currently trending cryptocurrencies displayed in JPY:

{
  "cryptoIds": [],
  "order": "trending",
  "vsCurrency": "jpy",
  "limit": "10"
}

Example 7: Custom Limit (e.g., 333 Cryptocurrencies)

Enter any custom number of cryptocurrencies you need:

{
  "cryptoIds": [],
  "limit": "333",
  "order": "market_cap_desc",
  "vsCurrency": "usd"
}

Requirements

• Apify account (free plan eligible)
• Basic cryptocurrency knowledge (optional)

Usage Tips

Best Practices

1. Set Appropriate Limits: Use reasonable limit values to avoid excessive data
2. Currency Selection: Choose the currency that matches your analysis needs
3. Sparkline Data: Enable only when needed, as it increases data size
4. Error Handling: The Actor automatically handles failures with detailed logging

Optimization

• For frequent runs, consider scheduling the Actor to run at regular intervals
• Filter specific cryptocurrencies if you only need a subset
• Disable unnecessary fields (market cap, volume) to reduce output size

Error Handling

The Actor includes comprehensive error handling:

• Network Errors: Automatically retries with exponential backoff
• Invalid Input: Validates parameters and logs warnings
• Timeout Handling: Respects configured timeout values
• Data Validation: Cleans and normalizes all output data

Limitations

• Maximum limit per request is 500 cryptocurrencies
• Sparkline data is limited to 7 days of history

Troubleshooting

No Data Returned

• Check internet connectivity
• Verify cryptocurrency IDs are valid
• Ensure data sources are accessible

Timeout Errors

• Increase the timeout parameter value
• Reduce the limit parameter
• Check your network connection stability

Incomplete Data

• Enable sparkline option for additional price history
• Ensure all data inclusion options are enabled
• Check if data is available for your selected cryptocurrencies

FAQ

Q: Which cryptocurrencies can I fetch? A: All major cryptocurrencies. Use the cryptoIds parameter with any valid cryptocurrency ID.

Q: How often can I run this Actor? A: As often as needed. Avoid excessive concurrent runs.

Q: Can I get historical data? A: The Actor provides 7-day sparkline history if enabled. For longer historical data, use dedicated historical data services.

Q: What's the difference between market cap rank and volume rank? A: Market cap rank sorts by total market value, while volume rank sorts by 24-hour trading volume.

Q: Can I use custom currencies? A: Currently supports: USD, EUR, GBP, JPY, CAD, AUD, INR, BRL.

Support

For issues, feature requests, or questions:

• Check the Actor's documentation
• Review error logs in the Actor's run console
• Contact Apify support for platform-related issues

Legal

This Actor respects all applicable terms of service and rate limits. Ensure your usage complies with relevant policies. The Actor does not store any personal information or credentials.