Bitcoin Price Predictor Actor

This Apify actor predicts Bitcoin prices using historical data and machine learning algorithms. It fetches real-time Bitcoin price data from CoinGecko's free API and generates forecasts using either linear regression or moving average models.

🚀 Features

• 📊 Real-time Data: Fetches current Bitcoin historical price data from CoinGecko
• 🤖 Dual Prediction Models: Choose between Linear Regression or Moving Average algorithms
• 📈 Flexible Timeframes: Predict anywhere from 1 to 30 days into the future
• 📉 Volatility Analysis: Calculates market volatility and price trends
• 🎯 Monthly Predictions: Optional 30-day long-term forecast
• 💾 Structured Output: Returns clean JSON data ready for analysis
• 🆓 No API Keys: Uses free CoinGecko API with no authentication required
• ⚡ Fast Execution: Typically completes in 10-30 seconds

📝 Input Parameters

Configure your prediction with these parameters:

Parameter	Type	Default	Range	Description
Prediction Days	Integer	7	1-30	Number of days into the future to predict
Historical Days	Integer	30	7-365	Days of historical data to analyze
Model Type	String	linear	linear, moving_average	Prediction algorithm to use
Include 30-Day Prediction	Boolean	true	true/false	Generate additional monthly forecast

Model Types

Linear Regression (linear)

• Best for markets with clear upward or downward trends
• Fits a mathematical trend line through historical data
• Good for stable, predictable price movements
• May not capture sudden market changes

Moving Average (moving_average)

• Best for volatile, unpredictable markets
• Uses recent price averages with volatility adjustments
• Adapts to market fluctuations
• May lag behind rapid trend changes

📊 Output

The actor returns a comprehensive dataset with the following structure:

{
  "timestamp": "2025-12-22T00:30:00.000Z",
  "currentPrice": "96845.50",
  "weeklyChangePercent": "3.45",
  "volatility": "2150.75",
  "historicalDays": 30,
  "predictionDays": 7,
  "modelType": "linear",
  "predictions": [
    {
      "date": "2025-12-23",
      "predictedPrice": "97500.00",
      "changeFromCurrent": "0.68%"
    },
    {
      "date": "2025-12-24",
      "predictedPrice": "98200.00",
      "changeFromCurrent": "1.40%"
    }
    // ... more predictions
  ],
  "monthlyPrediction": {
    "date": "2026-01-21",
    "predictedPrice": "102500.00",
    "changeFromCurrent": "5.84%",
    "daysAhead": 30
  },
  "historicalData": [
    {
      "date": "2025-12-12",
      "price": "94200.00"
    }
    // ... last 10 days
  ],
  "disclaimer": "This prediction is for educational purposes only. Cryptocurrency investments carry significant risk."
}

Output Fields Explained

• timestamp: When the prediction was generated (ISO 8601 format)
• currentPrice: Current Bitcoin price in USD
• weeklyChangePercent: Price change over the last 7 days
• volatility: Standard deviation of price movements (in USD)
• predictions: Array of daily predictions with dates and prices
• monthlyPrediction: 30-day forecast (if enabled)
• historicalData: Last 10 days of actual prices for context
• disclaimer: Important risk warning

💡 Use Cases

• Market Analysis: Track Bitcoin price trends and identify patterns
• Research Projects: Gather data for cryptocurrency studies
• Trading Insights: Generate predictions to inform trading strategies (educational only)
• Alert Systems: Build automated price monitoring systems
• Portfolio Tracking: Monitor crypto assets with predictive analytics
• Educational Tool: Learn about ML and financial forecasting
• Content Creation: Generate crypto market insights for blogs/newsletters

🔧 How to Use

Via Apify Console

1. Go to the actor page on Apify
2. Click "Try for free" or "Start"
3. Configure your input parameters
4. Click "Start" to run
5. View results in the Dataset tab
6. Download as JSON, CSV, or Excel

Via API

curl -X POST https://api.apify.com/v2/acts/YOUR_USERNAME~bitcoin-price-predictor/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "predictionDays": 7,
    "historicalDays": 30,
    "modelType": "linear",
    "includeMonthlyPrediction": true
  }'

Via Apify SDK (JavaScript/Node.js)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

// Start the actor
const run = await client.actor('YOUR_USERNAME/bitcoin-price-predictor').call({
    predictionDays: 7,
    historicalDays: 30,
    modelType: 'linear',
    includeMonthlyPrediction: true
});

// Fetch results
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log('Bitcoin Predictions:', items);

Via Apify SDK (Python)

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

# Start the actor
run = client.actor('YOUR_USERNAME/bitcoin-price-predictor').call(
    run_input={
        'predictionDays': 7,
        'historicalDays': 30,
        'modelType': 'linear',
        'includeMonthlyPrediction': True
    }
)

# Fetch results
items = client.dataset(run['defaultDatasetId']).list_items().items
print('Bitcoin Predictions:', items)

⏰ Scheduling

You can schedule the actor to run automatically:

1. Go to the actor page in Apify Console
2. Click the "Schedules" tab
3. Click "Create schedule"
4. Set your frequency:
   • Daily at 9 AM
   • Every 6 hours
   • Weekly on Mondays
   • Custom cron expression
5. Configure input parameters
6. Click "Create"

Recommended schedules:

• Daily traders: Every 6-12 hours
• Researchers: Daily at market open
• Long-term investors: Weekly or monthly

⚠️ Important Disclaimer

This actor is for educational and informational purposes only.

• Cryptocurrency price predictions are inherently uncertain
• Past performance does not guarantee future results
• Do NOT use as the sole basis for investment decisions
• Always do your own research (DYOR)
• Consult with financial advisors before investing
• Cryptocurrency investments carry significant risk
• You could lose all invested capital

🔍 Technical Details

Data Source

• API: CoinGecko Free Public API
• Endpoint: /api/v3/coins/bitcoin/market_chart
• Authentication: None required
• Rate Limits: Yes (standard CoinGecko limits apply)
• Data Format: Price in USD with timestamps

Prediction Algorithms

Linear Regression

• Calculates slope and intercept from historical data
• Formula: price = slope × day + intercept
• Extrapolates the trend line into the future
• Works well for linear trends but may overshoot on volatility

Moving Average with Volatility

• Calculates average of recent prices (window = 7 days)
• Computes standard deviation as volatility measure
• Applies random walk with volatility adjustments
• Better handles sideways or choppy markets

Volatility Calculation

1. Calculate daily returns: (price[i] - price[i-1]) / price[i-1]
2. Compute mean and variance of returns
3. Standard deviation = √variance
4. Scale to current price level

📊 API Limits & Best Practices

CoinGecko Free API Limits:

• Rate limited to ~10-50 calls per minute
• No authentication required
• May experience delays during high traffic

Best Practices:

• Don't run more than once per hour for the same timeframe
• Use Apify's scheduling feature to space out runs
• For high-frequency needs, consider CoinGecko's paid API
• Cache results when possible to reduce API calls

🛠️ Local Development

Want to run this actor locally?

# Clone or download the actor code
git clone <your-repo>
cd bitcoin-price-predictor

# Install dependencies
npm install

# Create input file
echo '{
  "predictionDays": 7,
  "historicalDays": 30,
  "modelType": "linear",
  "includeMonthlyPrediction": true
}' > .actor/INPUT.json

# Run the actor
npm start

🐛 Troubleshooting

Actor Fails to Run

• Check API Status: Verify CoinGecko API is accessible
• Review Logs: Click on the run to see detailed error messages
• Input Validation: Ensure parameters are within valid ranges
• Rate Limits: Wait a few minutes if you've made many requests

Unexpected Predictions

• Volatile Markets: Try switching to moving_average model
• More History: Increase historicalDays for better context
• Model Limitations: Remember these are statistical models, not crystal balls

No Data Returned

• API Issues: CoinGecko may be temporarily down
• Network Error: Check actor execution logs
• Empty Dataset: Ensure the actor completed successfully

💰 Cost & Performance

Typical Usage:

• Execution time: 10-30 seconds
• Compute units: ~0.001-0.005 per run
• Memory: <512 MB
• Cost: <$0.01 per run

Free Tier:

• Apify provides $5 free monthly
• Approximately 500-1000 free runs per month
• Perfect for personal use and testing

🔐 Privacy & Security

• No API keys or authentication required
• No personal data collected or stored
• All data comes from public CoinGecko API
• Runs in isolated Apify containers
• Results stored in your private Apify dataset

📈 Roadmap & Future Features

Potential enhancements:

• Multiple cryptocurrency support (ETH, BNB, etc.)
• Advanced ML models (LSTM, ARIMA)
• Confidence intervals for predictions
• Backtesting against historical accuracy
• Email/Slack notifications
• Chart generation and visualization
• Sentiment analysis integration
• Portfolio optimization suggestions

🤝 Support & Feedback

• Issues: Report bugs via Apify Console feedback
• Questions: Use Apify Community forums
• Feature Requests: Contact via actor page
• Documentation: https://docs.apify.com

📄 License

Apache-2.0

🙏 Acknowledgments

• CoinGecko: For providing free cryptocurrency data
• Apify: For the serverless actor platform
• Community: For feedback and suggestions

---

Remember: This is an educational tool. Always do your own research and never invest more than you can afford to lose. Happy predicting! 🚀📈