{"id":48630678,"url":"https://github.com/tubexchat/binance_tradingbot","last_synced_at":"2026-04-09T05:01:54.716Z","repository":{"id":345524793,"uuid":"1014650785","full_name":"tubexchat/binance_tradingbot","owner":"tubexchat","description":"负资金费率套利策略的币安合约自动化交易机器人","archived":false,"fork":false,"pushed_at":"2026-03-28T07:11:03.000Z","size":84,"stargazers_count":17,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-28T12:25:35.704Z","etag":null,"topics":["binance","trading","tradingbot"],"latest_commit_sha":null,"homepage":"https://q.tubex.chat","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tubexchat.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-06T06:18:21.000Z","updated_at":"2026-03-23T09:44:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tubexchat/binance_tradingbot","commit_stats":null,"previous_names":["tubexchat/binance_tradingbot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tubexchat/binance_tradingbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tubexchat%2Fbinance_tradingbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tubexchat%2Fbinance_tradingbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tubexchat%2Fbinance_tradingbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tubexchat%2Fbinance_tradingbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tubexchat","download_url":"https://codeload.github.com/tubexchat/binance_tradingbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tubexchat%2Fbinance_tradingbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31586410,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"online","status_checked_at":"2026-04-09T02:00:06.848Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binance","trading","tradingbot"],"created_at":"2026-04-09T05:01:54.024Z","updated_at":"2026-04-09T05:01:54.708Z","avatar_url":"https://github.com/tubexchat.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Binance AI Trading Bot\n\n一个基于负资金费率套利策略的币安合约自动化交易机器人，采用多指标融合分析，支持24/7不间断自动交易。\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://python.org)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Binance](https://img.shields.io/badge/Exchange-Binance_Futures-yellow.svg)](https://binance.com)\n\n## 📋 目录\n\n- [项目介绍](#项目介绍)\n- [交易策略](#交易策略)\n- [核心功能](#核心功能)\n- [快速开始](#快速开始)\n- [配置说明](#配置说明)\n- [使用方法](#使用方法)\n- [项目结构](#项目结构)\n- [监控管理](#监控管理)\n- [风险提示](#风险提示)\n- [故障排除](#故障排除)\n\n## 🎯 项目介绍\n\n这是一个专为币安合约市场设计的智能交易机器人，主要利用负资金费率进行套利交易。机器人采用多指标综合分析，包括资金费率、MACD、多空比和成交量等，实现全自动化的开仓和平仓操作。\n\n### 核心特性\n\n- 🎯 **负资金费率套利**: 专注于负资金费率机会，获取资金费用收益\n- 🔄 **全自动交易**: 自动扫描、开仓、平仓，无需人工干预\n- 📊 **多指标分析**: 结合MACD、多空比、成交量等多个指标\n- 🛡️ **风险控制**: 智能止损、黑名单、杠杆控制等安全机制\n- 📈 **实时监控**: 完整的账户和持仓监控系统\n- 🔧 **灵活配置**: 支持环境变量和命令行参数配置\n- 🚀 **后台运行**: 支持nohup后台运行，SSH断开后继续工作\n\n## 📊 交易策略\n\n### 做多开仓条件（需同时满足）\n\n```\n✅ 资金费率 \u003c -0.1%（负资金费率）\n✅ 24小时交易量 \u003e 6000万 USDT\n✅ MACD日级慢线 \u003e 0（日线趋势向上）\n✅ 多空比 \u003c 1（空头占优势）\n✅ 24小时涨跌幅 \u003e 0（当日上涨）\n✅ 资金费率结算时间为1小时（高频结算）\n✅ 剔除资金费率为0的合约\n```\n\n### 平仓条件\n\n```\n📈 当持仓合约不符合开仓条件时自动平仓：\n   • 资金费率 ≥ -0.1%（负资金费率减弱或转正）\n   • 24小时涨跌幅 ≤ 0（转为下跌）\n   • 资金费率结算时间不再是1小时\n⏰ 独立监控线程每5分钟检查一次持仓\n🔄 自动平仓，无需人工干预\n```\n\n### 策略逻辑\n\n1. **负资金费率套利**: 当资金费率为负时，做多可以获得资金费用收益\n2. **多指标筛选**: 确保选择的标的具有良好的技术面和市场结构\n3. **风险控制**: 通过杠杆限制、黑名单等机制控制风险\n4. **动态监控**: 实时监控资金费率变化，及时平仓\n\n## 🚀 核心功能\n\n### 自动化交易\n- ✅ 负资金费率扫描和筛选\n- ✅ 多指标技术分析（MACD、多空比、成交量）\n- ✅ 自动开仓和平仓\n- ✅ 动态杠杆和保证金管理\n- ✅ 黑名单过滤功能\n\n### 账户管理\n- ✅ 实时账户信息查询\n- ✅ 持仓和订单监控\n- ✅ 批量保证金模式设置\n- ✅ 交易历史记录查看\n\n### 系统监控\n- ✅ 详细日志记录\n- ✅ 进程状态监控\n- ✅ 实时性能数据\n- ✅ 异常告警和处理\n\n## 🛠 快速开始\n\n### 环境要求\n\n- Python 3.8+\n- 币安合约账户\n- API密钥（需要合约交易权限）\n\n### 1. 克隆项目\n\n```bash\ngit clone https://github.com/your-username/binance-ai-bot.git\ncd binance-ai-bot\n```\n\n### 2. 安装依赖\n\n```bash\npip3 install -r requirements.txt\n```\n\n### 3. 配置API密钥\n\n创建 `.env` 文件：\n```env\n# 币安API配置（必需）\nBINANCE_API_KEY=your_api_key_here\nBINANCE_API_SECRET=your_api_secret_here\n\n# 交易参数（可选）\nTRADE_AMOUNT=100\nLEVERAGE=2\nMONITOR_INTERVAL=300\nPOSITION_CHECK_INTERVAL=300\n\n# 黑名单设置（可选）\nBLACKLIST_SYMBOLS=LUNAUSDT,USTCUSDT\n\n# 测试环境（可选）\nUSE_TESTNET=false\n```\n\n### 4. 设置保证金模式\n\n```bash\n# 首次使用前必须设置为全仓模式\npython3 setup_margin_modes.py\n```\n\n### 5. 启动机器人\n\n```bash\n# 方式一：使用启动脚本（推荐）\n./start_bot.sh\n\n# 方式二：直接运行\npython3 auto_trading_bot.py\n```\n\n## ⚙️ 配置说明\n\n### 环境变量配置\n\n| 变量名 | 默认值 | 说明 |\n|--------|--------|------|\n| `BINANCE_API_KEY` | - | 币安API密钥（必需） |\n| `BINANCE_API_SECRET` | - | 币安API密钥（必需） |\n| `TRADE_AMOUNT` | 100 | 每次交易金额（USDT） |\n| `LEVERAGE` | 2 | 杠杆倍数 |\n| `MONITOR_INTERVAL` | 300 | 监控间隔（秒） |\n| `POSITION_CHECK_INTERVAL` | 300 | 持仓检查间隔（秒） |\n| `BLACKLIST_SYMBOLS` | - | 黑名单交易对（逗号分隔） |\n| `USE_TESTNET` | false | 是否使用测试网 |\n\n### 命令行参数\n\n```bash\npython3 auto_trading_bot.py --help\n\n可选参数:\n  --amount AMOUNT       每次交易金额(USDT，默认100)\n  --leverage LEVERAGE   杠杆倍数(默认2)\n  --interval INTERVAL   监控间隔(秒，默认300)\n  --position-check-interval INTERVAL\n                        持仓检查间隔(秒，默认300)\n  --testnet             使用测试网\n```\n\n## 💻 使用方法\n\n### 方式一：脚本管理（推荐）\n\n```bash\n# 启动机器人\n./start_bot.sh\n\n# 检查运行状态\n./check_bot.sh\n\n# 停止机器人\n./stop_bot.sh\n```\n\n### 方式二：交互式运行\n\n```bash\n# 使用默认参数\npython3 auto_trading_bot.py\n\n# 自定义参数\npython3 auto_trading_bot.py --amount 50 --leverage 5\n```\n\n### 方式三：后台运行\n\n```bash\n# 使用nohup后台运行\nnohup python3 run_auto_trading.py \u003e trading.log 2\u003e\u00261 \u0026\n```\n\n### 方式四：账户监控\n\n```bash\n# 查看账户信息\npython3 main.py\n\n# 调试持仓检查\npython3 debug_position_check.py\n```\n\n## 📁 项目结构\n\n```\nbinancebot-long-lewis/\n├── main.py                    # 核心API和交易逻辑\n├── auto_trading_bot.py        # 交互式启动脚本\n├── run_auto_trading.py        # 后台运行脚本\n├── setup_margin_modes.py      # 保证金模式设置工具\n├── debug_position_check.py    # 持仓检查调试工具\n├── start_bot.sh              # 启动脚本\n├── stop_bot.sh               # 停止脚本\n├── check_bot.sh              # 状态检查脚本\n├── requirements.txt          # 依赖列表\n├── .env                      # 环境变量配置\n└── logs/                     # 日志目录\n    ├── bot.pid              # 进程ID文件\n    └── trading_bot_*.log    # 交易日志\n```\n\n## 📈 监控管理\n\n### 实时监控\n\n```bash\n# 查看实时日志\ntail -f logs/trading_bot_*.log\n\n# 检查进程状态\n./check_bot.sh\n\n# 查看系统进程\nps aux | grep python3\n```\n\n### 日志分析\n\n日志文件包含以下信息：\n- 交易信号和决策过程\n- 开仓和平仓记录\n- 账户余额变化\n- 错误和异常信息\n- 性能统计数据\n\n### 性能监控\n\n```bash\n# 查看账户摘要\npython3 main.py\n\n# 获取持仓信息\npython3 -c \"from main import BinanceAccountMonitor; m = BinanceAccountMonitor(); m.print_positions()\"\n```\n\n## 🔧 API功能\n\n### BinanceFuturesAPI类\n\n```python\nfrom main import BinanceFuturesAPI\n\n# 初始化API\napi = BinanceFuturesAPI()\n\n# 获取账户信息\naccount = api.get_account_info()\npositions = api.get_positions()\nbalance = api.get_balance()\n\n# 交易操作\napi.place_order(symbol='BTCUSDT', side='BUY', order_type='MARKET', quoteOrderQty=100)\napi.close_position('BTCUSDT')\napi.set_leverage('BTCUSDT', 5)\n\n# 市场数据\nfunding_rates = api.get_funding_rates()\nklines = api.get_klines('BTCUSDT', '1d')\n```\n\n### AutoTradingBot类\n\n```python\nfrom main import AutoTradingBot\n\n# 初始化交易机器人\nbot = AutoTradingBot()\n\n# 设置交易参数\nbot.trade_amount = 100\nbot.leverage = 5\n\n# 启动监控\nbot.start_monitoring()\n```\n\n## ⚠️ 风险提示\n\n### 交易风险\n\n- 📊 **市场风险**: 合约交易存在价格波动风险\n- 💰 **杠杆风险**: 杠杆交易会放大盈亏\n- 🔄 **资金费率风险**: 资金费率可能快速变化\n- 📉 **技术风险**: 指标失效或网络问题\n\n### 使用建议\n\n1. **小额测试**: 首次使用建议小额测试\n2. **合理杠杆**: 不要使用过高杠杆倍数\n3. **监控止损**: 定期检查持仓和账户状态\n4. **备用方案**: 准备手动止损方案\n5. **资金管理**: 不要投入全部资金\n\n### 免责声明\n\n本项目仅供学习和研究使用，不构成投资建议。使用者需要承担所有交易风险，作者不对任何损失负责。\n\n## 🔍 故障排除\n\n### 常见问题\n\n1. **API连接失败**\n   ```bash\n   # 检查API密钥配置\n   cat .env | grep BINANCE_API\n   \n   # 测试API连接\n   python3 -c \"from main import BinanceFuturesAPI; api = BinanceFuturesAPI(); print(api.get_account_info())\"\n   ```\n\n2. **保证金模式错误**\n   ```bash\n   # 重新设置保证金模式\n   python3 setup_margin_modes.py\n   ```\n\n3. **机器人启动失败**\n   ```bash\n   # 查看详细日志\n   tail -50 logs/trading_bot_*.log\n   \n   # 检查进程状态\n   ./check_bot.sh\n   ```\n\n4. **权限问题**\n   ```bash\n   # 添加执行权限\n   chmod +x *.sh\n   ```\n\n### 调试命令\n\n```bash\n# 测试API连接\npython3 -c \"from main import BinanceFuturesAPI; api = BinanceFuturesAPI(); print('API连接成功')\"\n\n# 检查黑名单配置\npython3 -c \"from main import AutoTradingBot; bot = AutoTradingBot(); bot.debug_blacklist()\"\n\n# 查看资金费率\npython3 -c \"from main import BinanceFuturesAPI; api = BinanceFuturesAPI(); api.debug_funding_rates()\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftubexchat%2Fbinance_tradingbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftubexchat%2Fbinance_tradingbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftubexchat%2Fbinance_tradingbot/lists"}