Skip to main content

Installation

Get up and running with wisp in minutes.

Prerequisites​

You'll need Go installed to build and use wisp:

Check your Go version:

go version

Install wisp CLI​

Download the wisp repository from GitHub:

git clone https://github.com/wisp-trading/wisp
cd wisp

Build and install wisp:

make install

Verify the installation:

wisp --version

Create a New Strategy​

Initialize a new wisp project:

wisp init my-strategy
cd my-strategy

This creates:

  • strategy.go - Your strategy implementation
  • go.mod - Go dependencies
  • config.yaml - wisp configuration
  • README.md - Project documentation

Project Structure​

my-strategy/
├── strategy.go      # Your strategy code
├── go.mod           # Go module
├── config.yaml      # wisp config
└── README.md        # Documentation

Backtest Your Strategy​

Test your strategy with historical data:

wisp backtest

This runs your strategy against past market data and shows performance metrics:

  • Total return
  • Win rate
  • Maximum drawdown
  • Sharpe ratio
  • Number of trades

Backtest Options​

# Backtest specific date range
wisp backtest --start 2024-01-01 --end 2024-12-31

# Use specific exchange
wisp backtest --exchange binance

# Specify starting capital
wisp backtest --capital 10000

# Detailed output
wisp backtest --verbose

Deploy to Live Trading​

Once you're satisfied with backtest results, deploy your strategy:

wisp live

This starts your strategy in live trading mode. wisp will:

  1. Connect to your configured exchange(s)
  2. Start monitoring markets in real-time
  3. Execute trades based on your strategy signals
  4. Log all activity

Live Trading Options​

# Dry run (paper trading - no real orders)
wisp live --dry-run

# Specific exchange
wisp live --exchange binance

# Enable verbose logging
wisp live --verbose

# Custom config file
wisp live --config production.yaml

Configuration​

Before running live, configure your exchange API keys in config.yaml:

exchanges:
  binance:
    api_key: "your-api-key"
    api_secret: "your-api-secret"
    testnet: false
  
  bybit:
    api_key: "your-api-key"
    api_secret: "your-api-secret"
    testnet: false

strategy:
  name: "my-strategy"
  interval: "1h"
  assets:
    - "BTC"
    - "ETH"
warning

Never commit sensitive config files to version control. Keep config files with API keys out of your repository.

Quick Commands Reference​

# Create new strategy
wisp init <name>

# Backtest strategy
wisp backtest

# Run live (paper trading)
wisp live --dry-run

# Run live (real trading)
wisp live

# View logs
wisp logs

# Check status
wisp status

# Stop running strategy
wisp stop

Next Steps​