binance-spot-websocket-skill

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