Exchanges¶

CrackTrader connects to 100+ exchanges through CCXT. You configure one store per exchange and reuse it across feeds and brokers.

Supported Exchanges¶

Popular exchanges: - Binance — spot, futures, margin - Coinbase — spot - Kraken — spot, futures - Bybit — futures, spot - OKX — spot, futures, margin - Bitget — spot, futures - Gate.io — spot, futures

Full list: CCXT’s Supported Exchanges

Exchange Configuration¶

Binance¶

config = {'apiKey': 'your_api_key', 'secret': 'your_secret'}
store = CCXTStore(exchange='binance', sandbox=True, config=config)

Coinbase¶

config = {'apiKey': 'your_api_key', 'secret': 'your_secret', 'passphrase': 'your_passphrase'}
store = CCXTStore(exchange='coinbase', sandbox=True, config=config)

Kraken¶

config = {'apiKey': 'your_api_key', 'secret': 'your_secret'}
store = CCXTStore(exchange='kraken', config=config)

Exchange-Specific Features¶

Binance¶

Asset types: Spot, futures, margin
Timeframes: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M
Order types: Market, limit, stop, OCO, bracket
WebSocket: Real-time data feeds

Coinbase¶

Asset types: spot only
Timeframes: selected minutes/hours/days
Order types: market, limit, stop (varies)
WebSocket: real‑time data feeds

Adding New Exchanges¶

CrackTrader supports any CCXT exchange:

from cracktrader import CCXTStore

# Any CCXT exchange works
store = CCXTStore(exchange='bybit', sandbox=True)
store = CCXTStore(exchange='okx', sandbox=True)
store = CCXTStore(exchange='gate', sandbox=True)

Exchange Testing¶

Sandbox/Testnet Support¶

# Exchanges with sandbox support
sandbox_exchanges = [
    'binance',     # testnet.binance.vision
    'coinbase',    # public sandbox
    'bybit',       # api-testnet.bybit.com
    'okx'          # paper trading
]

# Test connection
store = CCXTStore(exchange='binance', sandbox=True)

Connection Testing¶

def test_exchange_connection(exchange_name, config):
    try:
        store = CCXTStore(config)
        # Test basic functionality
        markets = store.exchange.load_markets()
        balance = store.exchange.fetch_balance()
        print(f"{exchange_name}: Connected successfully")
        return True
    except Exception as e:
        print(f"{exchange_name}: Connection failed - {e}")
        return False

Rate Limits¶

Each exchange has different rate limits:

# Enable rate limiting (recommended)
store = CCXTStore(
    exchange='binance',
    config={'enableRateLimit': True, 'rateLimit': 1200}
)

Market Data¶

Available Data Types¶

OHLCV: candlestick data
Trades: individual trades
Order book: bid/ask levels
Ticker: 24h statistics
Balance: account balances

Timeframe Support¶

# Check supported timeframes
exchange = ccxt.binance()
print(exchange.timeframes)
# Output: {'1m': '1m', '3m': '3m', '5m': '5m', ...}

Commission Structures¶

Different exchanges have different fee structures:

from cracktrader.comm_info import BinanceCommissionInfo, CoinbaseCommissionInfo

# Binance: 0.1% maker/taker
binance_fees = BinanceCommissionInfo()

# Coinbase: 0.5% taker, 0.0% maker
coinbase_fees = CoinbaseCommissionInfo()

Multi-Exchange Trading¶

# Trade on multiple exchanges simultaneously
binance_store = CCXTStore(exchange='binance', sandbox=True)
coinbase_store = CCXTStore(exchange='coinbase', sandbox=True)

binance_data = CCXTDataFeed(binance_store, symbol='BTC/USDT', ccxt_timeframe='1h')
coinbase_data = CCXTDataFeed(coinbase_store, symbol='BTC-USD', ccxt_timeframe='1h')

cerebro = bt.Cerebro()
cerebro.adddata(binance_data, name='binance_btc')
cerebro.adddata(coinbase_data, name='coinbase_btc')

Exchange-Specific Considerations¶

Symbol Formats¶

Binance: BTC/USDT, ETH/USDT
Coinbase: BTC-USD, ETH-USD
Kraken: XXBTZUSD, XETHZUSD

Minimum Order Sizes¶

Binance BTC/USDT: 0.00001 BTC (example)
Coinbase BTC-USD: 0.001 BTC (example)
Kraken BTC/USD: 0.0001 BTC (example)

API Limits¶

See the exchange’s documentation for current limits

Best Practices¶

Use sandbox/testnet for development
Enable rate limiting to avoid bans
Check symbol formats for each exchange
Verify minimum order sizes before trading
Monitor API usage to stay within limits
Handle exchange-specific errors appropriately

Troubleshooting¶

Common Issues¶

Invalid API keys: Check config.json
Rate limit exceeded: Enable rate limiting
Symbol not found: Check exchange symbol format
Insufficient balance: Check account funding
Network errors: Check internet connection

Debug Mode¶

import logging
logging.getLogger('ccxt').setLevel(logging.DEBUG)

store = CCXTStore(config)
# Will show detailed API requests/responses