Chan/datasvc/README.md

Local Data Service (REST + WebSocket)

一键部署、跨平台的本地行情数据服务。默认抓取 Binance 永续合约 BTC/USDT:USDT, ETH/USDT:USDT 的 1m/5m/15m/1h K 线，增量写入本地 Parquet 并通过 WebSocket 推送。

快速开始（方式B：已安装 Docker）

cd user_data/Chan/datasvc
docker compose up -d

• REST: http://localhost:9000/api/candles?symbol=BTC/USDT:USDT&tf=1m
• WS: ws://localhost:9000/ws?symbol=BTC/USDT:USDT&tf=1m&since=1690000000000
• Swagger: http://localhost:9000/docs

环境变量（docker-compose.yml）

• EXCHANGE: 交易所，默认 binance
• SYMBOLS: 逗号分隔交易对
• TIMEFRAMES: 逗号分隔周期
• START_DAYS: 首次启动回补最近 N 天
• POLL_FACTOR: 轮询因子，间隔=周期毫秒*factor
• DATA_DIR: 容器内数据目录（已映射到 ./data）

数据位置

• 本地缓存：user_data/Chan/datasvc/data/{timeframe}/{symbol}.parquet

常用命令

docker compose logs -f

docker compose down

接口说明

• GET /api/candles
  • 参数：symbol, tf, start(ms), end(ms)
  • 返回：[{timestamp, open, high, low, close, volume}]
• WS /ws
  • 参数：symbol, tf, since(ms)
  • 消息：
    • snapshot: 初始快照数组
    • upsert: 单根K线增量（尾部修正）

注意

• 默认未带交易所 API Key，仅公共行情。
• 如需更多交易对/周期，修改 docker-compose.yml 后重启。