Golang 加密货币交易机器人

一个基于控制台的加密货币交易所交易机器人的 Go 实现。

使用方法

您可以下载发布的版本，或者直接从本仓库构建代码。

go get github.com/saniales/golang-crypto-trading-bot

如果需要，您可以创建一个策略并将其绑定到机器人：

import bot "github.com/saniales/golang-crypto-trading-bot/cmd"

func main() {
    bot.AddCustomStrategy(examples.MyStrategy)
    bot.Execute()
}

有关策略的参考，请参阅 Godoc 文档。

模拟模式

如果启用，机器人将进行模拟交易，即在沙盒环境中执行虚假订单。

若启用模拟模式，必须为每个交易所的每种币种指定一个假余额。

支持的交易所

交易所名称	REST 支持	WebSocket 支持
Bittrex	是	否
Poloniex	是	是
Kraken	是（不支持提现）	否
Bitfinex	是	是
Binance	是	是
Kucoin	是	否
HitBtc	是	是

配置文件模板

您可以根据此示例创建配置文件，或者运行编译后的可执行文件中的 init 命令。

simulation_mode: true # 如果您想启用模拟模式。
exchange_configs:
  - exchange: bitfinex
    public_key: bitfinex_public_key
    secret_key: bitfinex_secret_key
    deposit_addresses:
      BTC: bitfinex_deposit_address_btc
      ETH: bitfinex_deposit_address_eth
      ZEC: bitfinex_deposit_address_zec
    fake_balances: # 仅在启用模拟模式时使用，未启用时可省略。
      BTC: 100
      ETH: 100
      ZEC: 100
      ETC: 100
  - exchange: hitbtc
    public_key: hitbtc_public_key
    secret_key: hitbtc_secret_key
    deposit_addresses:
      BTC : hitbtc_deposit_address_btc
      ETH: hitbtc_deposit_address_eth
      ZEC: hitbtc_deposit_address_zec
    fake_balances:
      BTC: 100
      ETH: 100
      ZEC: 100
      ETC: 100
strategies:
  - strategy: strategy_name
    markets:
      - market: ETH-BTC
        bindings:
        - exchange: bitfinex
          market_name: ETHBTC
        - exchange: hitbtc
          market_name: ETHBTC
      - market: ZEC-BTC
        bindings:
        - exchange: bitfinex
          market_name: ZECBTC
        - exchange: hitbtc
          market_name: ZECBTC
      - market: ETC-BTC
        bindings:
        - exchange: bitfinex
          market_name: ETCBTC
        - exchange: hitbtc
          market_name: ETCBTC

捐赠

欢迎捐赠：

方式	地址
PayPal	https://paypal.me/AlessandroSanino
BTC	1DVgmv6jkUiGrnuEv1swdGRyhQsZjX9MT3
XVG	DFstPiWFXjX8UCyUCxfeVpk6JkgaLBSNvS
ETH	0x2fe7bd8a41e91e9284aada0055dbb15ecececf02
USDT	18obCEVmbT6MHXDcPoFwnUuCmkttLbK5Xo

golang-crypto-trading-bot 快速上手指南

环境准备

• 系统要求：支持 Linux、macOS 或 Windows。
• 前置依赖：
  • 已安装 Go (建议版本 1.16+)。
  • 配置好 Go 环境变量 (GOPATH, GOBIN)。
  • (可选) 国内开发者建议配置 Go 代理以加速下载：

    export GOPROXY=https://goproxy.cn,direct
    

安装步骤

你可以选择直接拉取源码构建，或下载预编译的 Release 版本。推荐使用以下命令直接安装：

go get github.com/saniales/golang-crypto-trading-bot

安装完成后，可执行文件通常位于 $GOPATH/bin 目录下。

基本使用

1. 初始化配置文件

首次使用前，需要创建配置文件。你可以运行编译后的可执行文件自带的 init 命令生成模板，或者手动创建 config.yaml 文件。

配置示例 (config.yaml)：

simulation_mode: true # 开启模拟交易模式（沙箱环境，不消耗真实资金）
exchange_configs:
  - exchange: bitfinex
    public_key: your_bitfinex_public_key
    secret_key: your_bitfinex_secret_key
    deposit_addresses:
      BTC: your_btc_address
    fake_balances: # 仅在 simulation_mode 为 true 时需要配置
      BTC: 100
strategies:
  - strategy: default_strategy_name # 替换为你使用的策略名称
    markets:
      - market: ETH-BTC
        bindings:
        - exchange: bitfinex
          market_name: ETHBTC

注意：若开启 simulation_mode，必须为每个交易所配置 fake_balances（虚拟余额）。

2. 自定义策略（可选）

如果你需要编写自己的交易策略，可以在 Go 代码中引入并绑定：

import bot "github.com/saniales/golang-crypto-trading-bot/cmd"

func main() {
    // 绑定自定义策略
    bot.AddCustomStrategy(examples.MyStrategy)
    // 执行机器人
    bot.Execute()
}

3. 启动机器人

配置完成后，在终端运行程序即可开始交易（或模拟交易）：

golang-crypto-trading-bot
# 或者如果未加入环境变量，使用完整路径运行
$GOPATH/bin/golang-crypto-trading-bot

程序将在控制台输出实时交易日志。支持的交易所在包括 Binance, Bitfinex, Poloniex, Kraken 等（详见项目文档中的 Supported Exchanges 列表）。