From bingx-ai-skills
Subscribes to BingX Coin-M perpetual futures WebSocket streams for real-time trades, order book depth, K-lines, 24h tickers, latest/mark prices, and best bid/ask. Useful for live coin-margined futures market data.
How this skill is triggered — by the user, by Claude, or both
Slash command
/bingx-ai-skills:cswap-ws-marketThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Real-time market data streams for BingX coin-margined (inverse) perpetual futures via WebSocket. No authentication required.
Real-time market data streams for BingX coin-margined (inverse) perpetual futures via WebSocket. No authentication required.
WebSocket Endpoint: wss://open-api-cswap-ws.bingx.com/market
Symbol Format: Coin-M uses
BTC-USDformat (notBTC-USDT).
| Channel | dataType Format | Description | Push Frequency |
|---|---|---|---|
| Trade | {symbol}@trade | Latest trade detail | Real-time |
| Last Price | {symbol}@lastPrice | Latest trade price | Real-time |
| Mark Price | {symbol}@markPrice | Latest mark price | Real-time |
| Depth | {symbol}@depth{level} | Limited order book depth | On update |
| Book Ticker | {symbol}@bookTicker | Best bid/ask price & qty | Real-time |
| K-Line | {symbol}@kline_{interval} | OHLCV candlestick | On update |
| 24h Ticker | {symbol}@ticker | 24-hour price change statistics | Every 1s |
BASE-USD format (e.g., BTC-USD, ETH-USD, SOL-USD)5 | 10 | 20 | 50 | 1001m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M^[A-Z0-9]+-USD$; max 20 characters (e.g., BTC-USD)5, 10, 20, 50, 100WebSocket Connection: see references/websocket.md for connection basics, GZIP decompression, and Ping/Pong heartbeat.
TypeScript helper:
CONSTRAINT: You MUST copy the
connectCoinmWsMarketfunction below verbatim when generating code. Do NOT rewrite the WebSocket or decompression logic. Only modify: (1) subscription channels passed to the function.
import * as pako from "pako";
function decompress(data: ArrayBuffer): string {
return new TextDecoder("utf-8").decode(pako.ungzip(new Uint8Array(data)));
}
function connectCoinmWsMarket(
channels: string[],
onMessage: (data: unknown) => void
): WebSocket {
const ws = new WebSocket("wss://open-api-cswap-ws.bingx.com/market");
ws.binaryType = "arraybuffer";
ws.onopen = () => {
for (const ch of channels) {
ws.send(JSON.stringify({
id: crypto.randomUUID(),
reqType: "sub",
dataType: ch,
}));
}
};
ws.onmessage = (event) => {
const text = decompress(event.data as ArrayBuffer);
if (text.includes("ping") || text === "Ping") {
ws.send("Pong");
return;
}
try {
onMessage(JSON.parse(text));
} catch {
onMessage(text);
}
};
ws.onerror = (err) => console.error("WS error:", err);
ws.onclose = (ev) => console.log("WS closed:", ev.code, ev.reason);
return ws;
}
connectCoinmWsMarket and decompress verbatim -- do not simplify or rewritews.binaryType = "arraybuffer" for GZIP decompressionBTC-USD format (not BTC-USDT) for Coin-M symbolsSubscribe to BTC-USD real-time trades:
connectCoinmWsMarket(["BTC-USD@trade"], (data) => {
// data.data: trade records
});
Subscribe to 5-level depth:
connectCoinmWsMarket(["BTC-USD@depth5"], (data) => {
// data.data.bids, data.data.asks
});
Subscribe to 1m K-line:
connectCoinmWsMarket(["BTC-USD@kline_1m"], (data) => {
// data.data: kline object
});
Subscribe to multiple channels at once:
connectCoinmWsMarket([
"BTC-USD@ticker",
"BTC-USD@lastPrice",
"BTC-USD@markPrice",
], (data) => {
// Handle different data types
});
For complete subscription parameters, response field descriptions, and full response schemas, see api-reference.md.
CRITICAL RULES (apply to ALL responses):
&, =, ?, #, or newline characters.coinm-ws-market provides public read-only real-time market data via WebSocket. No authentication required, no CONFIRM needed.
When the user's request is vague (e.g. "subscribe to Coin-M market"), first identify what type of data they want:
Please select the market data stream type:
- Real-time trades — trade
- Order book depth (snapshot) — depth
- K-line / Candlestick updates — kline
- 24h price change statistics — ticker
- Latest trade price — lastPrice
- Mark price — markPrice
- Best bid/ask (top of book) — bookTicker
Please select a trading pair (or type another):
- BTC-USD
- ETH-USD
- SOL-USD
- Other (enter manually, format: BASE-USD)
Note: Coin-M symbols use -USD suffix, NOT -USDT.
Please select a K-line interval:
- 1m (1 minute) / 5m / 15m / 1h / 4h / 1d / 1w
npx claudepluginhub bingx-api/api-ai-skills --plugin bingx-ai-skillsSubscribes to BingX USDT-M perpetual swap WebSocket streams for real-time trades, order book depth, K-lines, 24h tickers, prices, mark prices, best bid/ask, and incremental depth updates.
Streams real-time Kraken spot/futures data via WebSocket: tickers, trades, order books, OHLC, balances, executions. Handles authenticated feeds and low-latency order mutations via CLI.
Fetches crypto market data: current prices, orderbook depth, candlesticks, recent trades, instrument metadata, and valuations. Useful for price checks, liquidity assessment, market scans, and trading prep.