longbridge-depth
Orderbook depth, broker queue (HK-only), and tick-by-tick trades.
Response language: match the user's input language — Simplified Chinese / Traditional Chinese / English.
Subcommands
| Subcommand | Returns |
|---|---|
depth | 5 / 10-level orderbook: per-level price / volume / order_num |
brokers | Per-level broker_id queue (HK only). Tell the user the queue is HK-only when they ask about a non-HK symbol. |
trades | Latest N trades: time / price / volume / direction / type. Pass --count 1..1000. |
broker_id integers can be translated to names via longbridge-security-list → participants.
When to use
- "看下 700.HK 的盘口", "TSLA 5 档买卖盘" →
depth - "茅台经纪商队列" — non-HK symbol → tell user "broker queue is HK-only" and switch to
depth - "NVDA 最近 50 笔成交", "腾讯 tick 数据" →
trades --count 50 - "700 全部盘口", "microstructure overview" → call
depth,brokers(if HK), andtradesand merge the results
Workflow
- Resolve the symbol to
<CODE>.<MARKET>. - Pick the subcommand by user intent (table above). For an "overview" intent, run
depth+brokers(HK-only) +tradesand merge. - Off-hours warning: outside trading hours,
depthis the closing snapshot andtradesare the last N of the previous session — call this out explicitly when responding. - Call the Longbridge CLI directly (preferred) or fall back to MCP.
- Render
depthas a bid / ask table; describetradesas a direction summary (buy-dominant / sell-dominant) plus the latest few rows. Cite Longbridge Securities.
CLI
longbridge depth 700.HK --format json
longbridge brokers 700.HK --format json # HK-only
longbridge trades 700.HK --count 50 --format json
Always pass --format json so the output is machine-parseable.
Output
depth/brokers:{asks: [...], bids: [...]}(brokers[i]includes abroker_idarray)trades: array of trade rows (time / price / volume / direction / type)
Error handling
If longbridge is missing, fall back to MCP. If stderr surfaces "broker queue not supported" / "non-HK" on a brokers call, explain that broker queues are HK-only and switch to depth. Other stderr messages (auth / invalid symbol) get relayed verbatim.
MCP fallback
When the CLI is unavailable, fall back to the MCP server. Discover available tools from the MCP server's tool list at runtime — do not rely on hardcoded tool names.
MCP-only extensions are available; discover them from the MCP server's tool list at runtime.
Related skills
- Quote / static / indices →
longbridge-quote - Capital flow / large-order distribution →
longbridge-capital-flow - broker_id → name lookup →
longbridge-security-list
File layout
longbridge-depth/
└── SKILL.md # prompt-only, no scripts/