7.4 KiB

Raw Blame History

Crypto Features Installation Guide

Quick Install (2 minutes)

# Navigate to project directory
cd /Users/nguyenminhduc/Desktop/TradingAgents

# Install crypto dependencies
pip install ccxt glassnode python-dotenv

# Verify installation
python -c "import ccxt; print('CCXT version:', ccxt.__version__)"

# Run test suite
python test_crypto_data.py

Expected Output

================================================================================
  CRYPTO DATA INFRASTRUCTURE TEST SUITE - PHASE 1
================================================================================

✅ CCXT: PASSED
✅ MESSARI: PASSED
⚠️  GLASSNODE: SKIPPED (API key required)

Results: 2/2 tests passed

🎉 All crypto data tests passed! Phase 1 implementation complete.

Detailed Installation

Step 1: Check Python Version

python --version
# Should be Python 3.9 or higher

Step 2: Install Dependencies

pip install ccxt
pip install glassnode
pip install python-dotenv

Or install all at once:

pip install ccxt glassnode python-dotenv

Step 3: Verify Installation

# Test CCXT
python -c "import ccxt; exchange = ccxt.binance(); print(exchange.fetch_ticker('BTC/USDT'))"

# Test imports
python -c "from tradingagents.dataflows.ccxt_vendor import get_crypto_ohlcv; print('✅ Imports OK')"

Step 4: Set Up API Keys (Optional)

# Copy example env file
cp .env.example .env

# Edit .env with your API keys (only if you need them)
# For basic usage, you DON'T need any API keys!

What Works Without API Keys?

✅ CCXT - All public market data

Price data (OHLCV)
Tickers
Order books
Recent trades
All exchanges

✅ Messari - Basic data

Asset profiles
Tokenomics
News
Market metrics

❌ Glassnode - Requires paid API key

On-chain metrics
Whale activity
Exchange flows

Testing Your Installation

Test 1: Basic Connectivity

python test_crypto_data.py

Test 2: Run Examples

python examples/crypto_analysis_example.py

Test 3: Quick Python Test

# test_quick.py
from tradingagents.dataflows.ccxt_vendor import get_crypto_ticker

# Get Bitcoin price
ticker = get_crypto_ticker("BTC/USDT", "binance")
print(ticker)

Run it:

python test_quick.py

Troubleshooting

Error: ModuleNotFoundError: No module named 'ccxt'

Solution:

pip install ccxt --upgrade

Error: SSL Certificate Verify Failed

Solution (macOS):

/Applications/Python\ 3.x/Install\ Certificates.command

Or:

pip install certifi

Error: Exchange Connection Timeout

Solutions:

Check internet connection

Try different exchange:

get_crypto_ticker("BTC/USDT", "coinbase")

Check if exchange is down: https://status.binance.com/

Error: Rate Limit Exceeded

Solution: CCXT automatically handles rate limits. If you see this, wait a few seconds and retry.

Import Error: tradingagents not found

Solution: Run from project root:

cd /Users/nguyenminhduc/Desktop/TradingAgents
python test_crypto_data.py

Advanced Setup

Using Virtual Environment (Recommended)

# Create virtual environment
python -m venv venv

# Activate
source venv/bin/activate  # macOS/Linux
# or
venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

Installing from requirements.txt

pip install -r requirements.txt

This will install all dependencies including:

ccxt (crypto exchange integration)
glassnode (on-chain analytics)
python-dotenv (environment variables)
All existing TradingAgents dependencies

API Key Setup (Optional)

Get API Keys

CCXT (for trading - not needed for data):

Binance: https://www.binance.com/en/my/settings/api-management
Coinbase: https://www.coinbase.com/settings/api
Kraken: https://www.kraken.com/u/security/api

Glassnode (for on-chain data):

Sign up: https://studio.glassnode.com/
Plans start at $30/month

Messari (optional - free tier available):

Sign up: https://messari.io/api
Free tier: 20 requests/minute

Configure .env File

# .env
BINANCE_API_KEY=your_actual_api_key_here
BINANCE_API_SECRET=your_actual_secret_here

GLASSNODE_API_KEY=your_glassnode_key_here
MESSARI_API_KEY=your_messari_key_here

⚠️ Important: Never commit .env file to git!

Verifying Everything Works

Complete Verification Script

# verify_install.py
import sys

def verify():
    print("Checking crypto installation...\n")

    # Test 1: CCXT
    try:
        import ccxt
        print("✅ CCXT installed:", ccxt.__version__)
    except ImportError:
        print("❌ CCXT not installed")
        return False

    # Test 2: Connectivity
    try:
        exchange = ccxt.binance()
        ticker = exchange.fetch_ticker('BTC/USDT')
        print(f"✅ Exchange connectivity OK (BTC price: ${ticker['last']:,.2f})")
    except Exception as e:
        print(f"❌ Exchange connectivity failed: {e}")
        return False

    # Test 3: Imports
    try:
        from tradingagents.dataflows.ccxt_vendor import get_crypto_ohlcv
        from tradingagents.dataflows.messari_vendor import get_crypto_fundamentals_messari
        print("✅ TradingAgents crypto modules OK")
    except ImportError as e:
        print(f"❌ Import failed: {e}")
        return False

    print("\n🎉 Installation verified! Ready to use crypto features.")
    return True

if __name__ == "__main__":
    success = verify()
    sys.exit(0 if success else 1)