BitBank Binance Bot

Open-source Go follower bot for BitBank forecasts on Binance Spot.

The bot polls BitBank public signals, filters them by configured pairs and confidence, and places market orders on Binance when live trading is explicitly enabled. It starts in dry-run mode and is intended as a small auditable example, not as financial advice or a profit guarantee.

Safety defaults

• BITBANK_DRY_RUN=true by default.
• Live trading requires BITBANK_DRY_RUN=false, BITBANK_ALLOW_LIVE_TRADING=true, and BITBANK_CONFIRM_LIVE_TRADING=I_UNDERSTAND.
• Sell orders are disabled unless BITBANK_ALLOW_SELL=true and a base quantity is configured. This avoids accidental full-position liquidation.
• Duplicate signals are persisted in BITBANK_STATE_FILE so a restart does not immediately repeat the same order.

Quick start

go run ./cmd/bitbank-binance-bot -once

Example dry run:

export BITBANK_PAIRS=BTC_USDT,ETH_USDT,SOL_USDT
export BITBANK_ORDER_QUOTE_AMOUNT=25
export BITBANK_MIN_CONFIDENCE=0.60
go run ./cmd/bitbank-binance-bot

Live trading, after reviewing the code and exchange permissions:

export BINANCE_API_KEY=...
export BINANCE_API_SECRET=...
export BITBANK_DRY_RUN=false
export BITBANK_ALLOW_LIVE_TRADING=true
export BITBANK_CONFIRM_LIVE_TRADING=I_UNDERSTAND
go run ./cmd/bitbank-binance-bot

Configuration

Variable	Default	Description
BITBANK_API_URL	https://bitbank.nz	BitBank API base URL.
BITBANK_PAIRS	BTC_USDT,ETH_USDT,SOL_USDT	Comma-separated BitBank pairs.
BITBANK_POLL_INTERVAL	1m	Poll loop interval.
BITBANK_MIN_CONFIDENCE	0.55	Minimum signal confidence.
BITBANK_ORDER_QUOTE_AMOUNT	25	Quote amount for buy orders.
BITBANK_ORDER_BASE_AMOUNT	empty	Base quantity for sell orders.
BITBANK_ALLOW_SELL	false	Enable market sells when a sell signal appears.
BITBANK_STATE_FILE	state/bitbank-binance-bot.json	Signal de-duplication state.
BINANCE_BASE_URL	https://api.binance.com	Binance REST API base URL.
BINANCE_API_KEY	empty	Binance API key.
BINANCE_API_SECRET	empty	Binance API secret.

Notes

BitBank pairs use BASE_QUOTE format such as BTC_USDT. Binance order symbols remove the separator, for example BTCUSDT.

This project intentionally keeps the strategy simple: it follows BitBank's latest public buy and sell signals rather than training local models. Add exchange filters, minimum notional checks, and portfolio-aware sizing before using it with meaningful capital.