SuperAPI AI 工具集

binance-spot-websocket-skill

数据与分析

查看项目

更新于 10-16 08:48

技能介绍

用途:通过 uxc subscribe raw WebSocket 模式订阅币安现货(Binance Spot)公开市场行情流,将事件写入 NDJSON 文件供后续处理。通用运行时行为、sink 处理与事件信封解析复用 uxc 技能。

主要能力:覆盖成交事件、归集成交事件、book ticker 更新、ticker 更新与深度更新等公开行情流。不覆盖币安现货 REST/OpenAPI 流程、私有用户数据流、签名 WebSocket API 方法,以及杠杆、钱包、合约等非现货产品。

端点模型:首选基址 wss://stream.binance.com:443;原始流形式 wss://stream.binance.com:443/ws/<streamName>;组合流形式 wss://stream.binance.com:443/stream?streams=<stream1>/<stream2>。流名须小写,连接最长有效 24 小时;原始流负载直接为 JSON 对象,组合流负载为 {"stream":"...","data":{...}}。

使用方式:先确保 uxc 已安装并在 PATH 中,具备网络访问与可写 sink 路径。启动订阅示例:uxc subscribe start wss://stream.binance.com:443/ws/btcusdt@trade --transport websocket --sink file:$HOME/.uxc/subscriptions/binance-btcusdt-trade.ndjson。查看输出:tail -n 5 $HOME/.uxc/subscriptions/binance-btcusdt-trade.ndjson。查询状态:uxc subscribe list、uxc subscribe status <job_id>。停止:uxc subscribe stop <job_id>。常见流目标包括 btcusdt@trade、btcusdt@aggTrade、btcusdt@bookTicker、btcusdt@miniTicker、btcusdt@ticker、btcusdt@depth。

适用场景:需要将币安现货公开行情以只读方式采集并落盘为 NDJSON 的自动化流程。

限制与注意:保持使用 JSON 输出信封,不要用 --text;优先解析稳定字段 event_kind、data、meta;默认使用 wss://stream.binance.com:443;流名必须小写;本技能为只读,不应描述为账户、下单或签名 WebSocket 支持;组合流可让单个任务向同一 sink 输出多个市场,但下游解析需处理 stream 包装。执行路径为 uxc subscribe start ... --transport websocket,uxc link 不是主要接口。参考:references/usage-patterns.md 与 https://developers.binance.com/docs/binance-spot-api-docs/web-socket-streams。