BTC_MASTER

BTC Master Hack - 部署与启动说明项目介绍BTC Master Hack 是一个面向加密市场的多服务数据与策略系统，覆盖从行情采集到指标聚合，再到 AI 决策与交易执行的完整链路。项目目标是提供一个可持续运行、可扩展、可观测的量化基础框架，适合黑客松演示和后续工程化迭代。核心能力：多市场数据同步：现货、永续、期权、订单簿、持仓与多空比历史修复与实时增量并行：保证数据连续性与时效性指标引擎与 API 服务：统一输出指标历史与实时订阅LLM 决策与交易执行：支持策略评估、动作建议与执行链路联动核心服务：data_repair：历史数据修复任务data_sync：实时数据同步任务indi_sync：指标服务、LLM 决策与交易执行（默认对外 8082）策略说明（黑客松版本）为满足黑客松提交要求，仓库中的核心指标策略与决策细节已做脱敏/示例化处理：保留了完整的数据链路、指标服务接口与系统启动流程对关键策略组合逻辑与私有阈值做了隐藏处理，仅保留公开演示用逻辑不影响本 README 中的环境配置与三服务启动方式如需恢复生产策略，请在私有仓库或私有模块中接入真实策略实现。以下为部署与启动说明。1. 环境准备在项目根目录执行，确保以下工具可用：DockerDocker Compose（docker-compose 命令）2. 配置生产环境变量docker-compose.yml 里固定设置了 ENV=prod，程序会自动加载：config/.env.prod请先复制模板：cp config/.env.prod.template config/.env.prod然后编辑 config/.env.prod，至少确认以下配置：2.1 必填（建议）ClickHouseCLICKHOUSE_HOSTCLICKHOUSE_PASSWORDCLICKHOUSE_USER（如非默认请显式填写）CLICKHOUSE_DATABASE（如非默认请显式填写）CLICKHOUSE_PORT（如非默认端口请填写）DeribitDERIBIT_API_KEYDERIBIT_API_SECRETLLM（若使用 LLM 决策）DMX_API_TOKEN交易（按你实际执行通道启用）Binance: BINANCE_ENABLE=true + BINANCE_API_KEY + BINANCE_API_SECRETLighter: LIGHTER_ENABLE=true + LIGHTER_ACCOUNT_INDEX + LIGHTER_PUBKEY + LIGHTER_API_PRIVATE_KEY（或 LIGHTER_PRIVILY）2.2 代理（可选）PROXY_ENABLE=true|falsePROXY_HOSTPROXY_URLCLICKHOUSE_PROXY不使用代理时，可设置：PROXY_ENABLE=false2.3 交易模式与通知（可选）TRADE_MODE（按你的策略模式）TRADE_SIMULATION=true|falseTELEGRAM_BOT_TOKENTELEGRAM_CHAT_IDTELEGRAM_THREAD_ID3. 启动 3 个服务（按脚本）在项目根目录执行：./rebuild_data_repair.sh ./rebuild_data_sync.sh ./rebuild_indi_sync.sh脚本行为：停止旧容器（若存在）删除旧容器强制重建并后台启动对应服务4. 启动后检查查看容器状态：docker-compose ps查看服务日志：docker-compose logs -f data_repair docker-compose logs -f data_sync docker-compose logs -f indi_sync指标服务接口默认：http://localhost:8082健康检查示例：curl http://localhost:8082/api/indicators5. 常见问题启动后无数据：先检查 CLICKHOUSE_*、DERIBIT_* 配置是否正确。LLM 无决策写入：检查 DMX_API_TOKEN 是否配置。交易未执行：检查 BINANCE_ENABLE / LIGHTER_ENABLE 与对应 API 凭证。可先用 TRADE_SIMULATION=true 验证流程。