Skip to content

Latest commit

 

History

History
266 lines (173 loc) · 14.3 KB

README.zh-cn.md

File metadata and controls

266 lines (173 loc) · 14.3 KB
Raw

Binance Trading Bot

GitHub version Build CodeCov Docker pull GitHub contributors MIT License

币安跟踪委托单高买低卖策略交易机器人

en ko

这只是一个测试项目，代码正在测试中。

警告

我不能保证你能通过这个项目来挣钱 所以，使用这个项目的风险由你自己承担，我对使用此代码直接或间接引起的任何损失不承担任何责任。在使用本项目前请先阅读免责协议。 在更新机器人之前，请确保记录最后的买入价格。更新后可能会丢失配置或最后的买入价格记录。

工作原理

跟踪委托买入/卖出机器人

这个机器人使用跟踪买入/卖出订单的概念，跟踪价格的下跌/上涨。

跟踪委托单 关于跟踪委托的信息可以看币安的官方文档

简单来说就是在价格变化时，按固定的数值或百分比进行委托。利用这个特性可以在下跌买入时买到尽可能低的价格，在上涨卖出时卖出最高的价格。

  • 该机器人可以监测多个代币，并对每个代币的价格进行每秒监测。
  • 这个机器人只在 USDT 交易对中测试过，比如 BTC/USDT，ETH/USDT。你也可以添加其他与法币锚定的稳定币，比如 BUSD、AUD。但是我并没有使用这些稳定币在生产环境测试过，请自行承担风险。
  • 该机器人使用 MongoDB 数据库。然而，它并没有没有使用最新的 MongoDB 来支持Raspberry Pi 32bit，使用的 MongoDB 版本是3.2.20，这是由 apcheamitru 提供的。

买入信号（Buy Signal）

该机器人将持续监测一段时间内的最低值。一旦当前价格达到最低价格，那么机器人将下达买入的 "止损限价单（STOP-LOSS-LIMIT）"指令。如果当前价格持续下跌。那么机器人将取消之前的订单，并重新放置新的"止损限价单（STOP-LOSS-LIMIT）"订单。

  • 当达到卖出的触发价格时，如果有足够的持仓（通常超过10美元），机器人就不会再下买单。
买入方案

比方说，使用如下买入配置设置：

  • 最大购买金额(Maximum purchase amount): $50
  • 触发百分比(Trigger percentage): 1.005 (0.5%)
  • 止损百分比(Stop price percentage): 1.01 (1.0%)
  • 限价百分比(Limit price percentage): 1.011 (1.1%)

市场情况如下：

  • 市场价: $101
  • 限价: $100
  • 触发价: $100.5

现在机器人不会下单，因为触发价（100.5）低于现价（101）

在下一次市场成交后（next tick），市场情况现在如下：

  • 市场价: $100
  • 限价: $100
  • 触发价: $100.5

现在，机器人会新建一个限价止损单来买入，因为现价($100)已经低于了触发价($100.5)。为了简化计算，这里没有考虑佣金。在真实的交易中，数量会有不同。新的买入订单会被执行如下：

  • 止损价 Stop price: $100 * 1.01 = $101
  • 限价 Limit price: $100 * 1.011 = $101.1
  • 数量: 0.49

在下一次市场成交后（next tick），市场情况现在如下：

  • 现价: $99
  • 当前限价 Current limit price: $99 * 1.011 = 100.089
  • 未平仓止损价 Open order stop price: $101

由于当前的未平仓止损价 101 高于当前限价 100.089，机器人会取消当前的订单并按以下方式重新下单

  • 止损价 Stop price: $99 * 1.01 = $99.99
  • 限价 Limit price: $99 * 1.011 = $100.089
  • 数量 Quantity: 0.49

如果价格不断下跌，这个新的买单也会不断更新报价。

接下来在一次市场成交后（next tick），市场情况如下：

  • 现价 Current price: $100

现在当前价格到了止损价（99.99），因此，买单将会按限价 100.089 报价下单。

卖出信号

如果有足够的余额用于卖出，并且最后的买入价格已被记录，那么机器人将开始监测卖出信号。一旦当前价格达到触发价格，机器人将下达一个止损限价单来卖出。如果当前价格持续上涨，那么机器人将取消之前的订单，并重新以新的价格重新下新的止损限价单。

  • 如果该币的价值低于10美元（最低名义价值），那么机器人将删除最后的买入价格，因为Binance不允许下低于10美元的订单。
  • 如果机器人没有最后买入价格的记录，机器人将不会卖出该币。

卖出方案

比方说，使用如下卖出配置设置：

  • 触发百分比 Trigger percentage: 1.05 (5.0%)
  • 止损百分比 Stop price percentage: 0.98 (-2.0%)
  • 限价百分比 Limit price percentage: 0.979 (-2.1%)

同时市场行情如下：

  • 剩余代币数量 Coin owned: 0.5
  • 市场价 Current price: $100
  • Last buy price: $100
  • 触发价 Trigger price: $100 * 1.05 = $105

这时机器人将不会提交订单，因为触发价($105)低于市场价($100)

如果价格持续走低，机器会持续监控价格，直到价格达到触发价

接下来在一次市场成交后（next tick），市场行情如下：

  • 市场价 Current price: $105
  • 触发价 Trigger price: $105

机器人将提交新的止损限价单进行卖出，因为当前的价格（$105）高于或等于触发价格（$105）。 为了简化计算，我没有考虑佣金。在实际交易中，数量可能会有所不同。新的卖单将被提交如下：

  • 止损价 Stop price: $105 * 0.98 = $102.9
  • 限价 Limit price: $105 * 0.979 = $102.795
  • 数量 Quantity: 0.5

接下来在一次市场成交后（next tick），市场情况如下：

  • 市场价 Current price: $106
  • 当前限价 Current limit price: $103.774
  • 开仓止损价 Open order stop price: $102.29

由于未平仓订单的止损价格（$102.29）低于当前的限价($103.774)，机器人将取消未平仓订单，并提交新的止损限价单，如下所示：

  • 止损价 Stop price: $106 * 0.98 = $103.88
  • 限价 Limit price: $106 * 0.979 = $103.774
  • 数量 Quantity: 0.5

如果市场价不断升高，新的卖单也会更新报价。

如果市场价格变化：

  • 市场价 Current price: $103

目前的价格达到了止损价（$103.88）；因此，订单将以限价（$103.774）执行。

功能

  • 手动交易
  • 小资产转BNB
  • 交易所有硬币
  • 同时监控多个硬币
  • 止损

前端 + WebSocket

基于 React.js 的前端，通过 Web Socket 通信:

  • List monitoring coins with buy/sell signals/open orders
  • View account balances
  • Manage global/symbol settings
  • Delete caches that are not monitored
  • Link to public URL
  • Support Add to Home Screen

环境变量

通过环境变量调整参数. 参考/config/custom-environment-variables.json 查看所有的环境变量.

或者在应用启动后调整参数。

使用方法

  1. 基于 .env.dist创建 .env 文件

    Environment Key Description Sample Value
    BINANCE_LIVE_API_KEY Binance API key for live (from Binance)
    BINANCE_LIVE_SECRET_KEY Binance API secret for live (from Binance)
    BINANCE_TEST_API_KEY Binance API key for test (from Binance Spot Test Network)
    BINANCE_TEST_SECRET_KEY Binance API secret for test (from Binance Spot Test Network)
    BINANCE_SLACK_ENABLED Slack enable/disable true
    BINANCE_SLACK_WEBHOOK_URL Slack webhook URL (from Slack)
    BINANCE_SLACK_CHANNEL Slack channel "#binance"
    BINANCE_SLACK_USERNAME Slack username Chris
    BINANCE_LOCAL_TUNNEL_ENABLED Enable/Disable local tunnel true
    BINANCE_LOCAL_TUNNEL_SUBDOMAIN Local tunnel public URL subdomain binance

  2. Check docker-compose.yml for BINANCE_MODE environment parameter

  3. Launch/Update the bot with docker-compose

    Pull latest code first:

    git pull

    If want production mode, then use the latest build image from DockerHub:

    docker-compose -f docker-compose.server.yml pull
docker-compose -f docker-compose.server.yml up -d

    Or if using Raspberry Pi 4 32bit, must build again for Raspberry Pi:

    npm run docker:build
docker-compose -f docker-compose.rpi.yml up -d

    Or if want development mode, then run below commands:

    docker-compose up -d

  4. Open browser http://0.0.0.0:8080 to see the frontend

    • When launching the application, it will notify public URL to the Slack.
    • If you have any issue with the bot, you can check the log to find out what happened with the bot. Please take a look Troubleshooting

Install via Stackfile

  1. In Portainer create new Stack

  2. Copy content of docker-stack.yml or upload the file

  3. Set environment keys for binance-bot in the docker-stack.yml

  4. Launch and open browser http://0.0.0.0:8080 to see the frontend

截图

前端 移动端 设置 手工交易
Frontend Mobile Setting Manual Trade
Frontend Desktop
Frontend Desktop

Sample Trade

图表 买单 卖单
Chart Buy Orders Sell Orders

Donations

如果你觉得这个项目对你有帮助，欢迎你给开发者一个小小的捐赠

免责声明

我对本项目所包含的信息和材料的准确性或完整性不作任何保证，也不承担任何责任或义务。在任何情况下，对于因您使用或无法使用本代码或与之链接的任何代码，或因您依赖本代码上的信息和材料而直接或间接导致的任何索赔、损害、损失、费用、成本或责任（包括但不限于任何利润损失、业务中断或信息损失的直接或间接损害），我不承担任何责任或义务，即使我已事先被告知此类损害的可能性。

所以请自行承担所有风险!