360 Secure SkillHub
360 安全技能中心

Binance Spot WebSocket Skill

该 Skill 使用 uxc 的原始 WebSocket 订阅模式连接 Binance Spot 公共行情流（逐笔、聚合逐笔、盘口、行情与深度），把事件以 NDJSON 写入指定 sink 文件，并给出启动、查看状态与停止任务的步骤；仅覆盖只读公共数据，不含私有流、签名接口或 REST 工作流。

jolestar
jolestar
热度 60.69
最近更新 2026-05-11 17:32:08
分类：数据依赖：代码执行 / 读写文件 / 第三方 API应用场景：数据处理 / 财务 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add binance-spot-websocket-skill
Metadata
name
binance-spot-websocket-skill
description
Subscribe to Binance Spot public market streams through UXC raw WebSocket support for trades, book ticker, depth, and ticker events with stream-specific guardrails.

Binance Spot WebSocket Skill

Use this skill to run Binance Spot public market streams through uxc subscribe raw WebSocket mode.

Reuse the uxc skill for generic runtime behavior, sink handling, and event-envelope parsing.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to Binance Spot public WebSocket streams.
  • A writable sink path for NDJSON output.

Scope

This skill covers Binance Spot public market streams such as:

  • trade events
  • aggregate trade events
  • book ticker updates
  • ticker updates
  • depth updates

This skill does not cover:

  • Binance Spot REST/OpenAPI workflows
  • private user data streams
  • signed WebSocket API methods
  • margin, wallet, futures, or other non-Spot product families

Endpoint Model

Binance Spot public market streams use raw WebSocket endpoints.

  • preferred base: wss://stream.binance.com:443
  • raw stream form: wss://stream.binance.com:443/ws/<streamName>
  • combined stream form: wss://stream.binance.com:443/stream?streams=<stream1>/<stream2>

Important:

  • stream names are lowercase
  • connections are valid for up to 24 hours
  • raw stream payloads arrive directly as JSON objects
  • combined stream payloads arrive as {"stream":"...","data":{...}}

Core Workflow

  1. Start a subscription directly with uxc subscribe start:
    • uxc subscribe start wss://stream.binance.com:443/ws/btcusdt@trade --transport websocket --sink file:$HOME/.uxc/subscriptions/binance-btcusdt-trade.ndjson
  2. Inspect the sink output:
    • tail -n 5 $HOME/.uxc/subscriptions/binance-btcusdt-trade.ndjson
  3. Query runtime status:
    • uxc subscribe list
    • uxc subscribe status <job_id>
  4. Stop the job when finished:
    • uxc subscribe stop <job_id>

Common Stream Targets

  • raw trade stream:
    • btcusdt@trade
  • aggregate trade stream:
    • btcusdt@aggTrade
  • book ticker stream:
    • btcusdt@bookTicker
  • mini ticker stream:
    • btcusdt@miniTicker
  • rolling ticker stream:
    • btcusdt@ticker
  • depth stream:
    • btcusdt@depth

Runtime Validation

The following live raw WebSocket flow was validated successfully through uxc:

  • endpoint: wss://stream.binance.com:443/ws/btcusdt@trade
  • transport: --transport websocket
  • sink output:
    • open
    • repeated data events with Binance trade payloads
    • closed after stop

Observed event fields included:

  • e: "trade"
  • s: "BTCUSDT"
  • p
  • q
  • t

Guardrails

  • Keep automation on the JSON output envelope; do not use --text.
  • Parse stable event fields first: event_kind, data, meta.
  • Use wss://stream.binance.com:443 as the default public stream host; it validated more reliably than :9443 in recent runtime checks.
  • Stream names must be lowercase.
  • This skill is read-only. Do not describe it as account, order, or signed WebSocket support.
  • Combined streams are useful when one job should emit multiple markets into one sink, but downstream parsing must handle stream wrappers.
  • uxc subscribe start ... --transport websocket is the intended execution path for this skill; uxc link is not the main interface because stream identity is encoded directly in the endpoint path.

References