longbridge-market-data – Data & Science skill for AI agents

Bundled upstream support

Supporting files are included at skill-relative paths. See [UPSTREAM-NOTICE.md](UPSTREAM-NOTICE.md) for their pinned sources, licenses, hashes, and import changes.

Longbridge Market Data

Real-time and historical market data for HK / US / A-share / Singapore via the Longbridge CLI.

> Response language: match the user's input language — English / Simplified Chinese / Traditional Chinese.

> RULE: Response language priority: English is the default when language is ambiguous. If the user input is only a slash command, command name, ticker / symbol, or contains no natural-language language signal, you MUST respond in English. Do not infer Chinese from trigger keywords, skill metadata, or examples.

> Data-source scope: prefer the configured Longbridge connection for supported data. If required timestamps, ADR ratios, benchmark rates or history are unavailable, disclose the gap; use an authorized primary source or leave the calculation incomplete. Do not fill current financial inputs from model memory.

When to use

Trigger when the user asks about: stock price / quote, K-line / candlestick chart, order book depth, recent trades / ticks, intraday capital flow, market sentiment index, trading session status, exchange rates, IPO calendar / subscription, security lists, ADR premium, or FX carry trade analysis.

Sub-topic Routing

| User intent | Load references file |

|---|---|

| Real-time quote / price | references/quote.md |

| K-line / chart / OHLCV | references/kline.md |

| Order book / 盘口 | references/depth.md |

| Recent trades / ticks | references/trades.md |

| Intraday minute chart | references/intraday.md |

| Capital flow / 资金流 | references/capital.md |

| Market sentiment / 温度 | references/market-temp.md |

| Trading session / calendar | references/trading.md |

| Security list / overnight | references/security-list.md |

| Market maker / participants | references/participants.md |

| WebSocket subscriptions | references/subscriptions.md |

| A/H premium | references/ah-premium.md |

| Trade statistics / volume profile | references/trade-stats.md |

| Market open/close status | references/market-status.md |

| Exchange rate / FX | references/exchange-rate.md |

| IPO calendar / subscription | references/ipo.md |

| ADR premium / cross-market | references/adr-premium.md |

| FX carry trade | references/fx-carry.md |

CLI Commands

Run longbridge --help to list all subcommands. Run longbridge <cmd> --help for flags.

quote — real-time quote for one or more symbols

depth — Level 2 order book (bid/ask ladder)

brokers — broker queue at each price level (HK only)

trades — recent tick-by-tick trades

intraday — intraday minute-by-minute price and volume

kline — OHLCV candlestick data or historical date-range

static — static reference info (name, listing exchange, lot size, etc.)

calc-index — calculated indexes (PE, PB, turnover rate, DPS rate)

capital — intraday capital distribution or flow time series

market-temp — market sentiment index (0–100)

trading — trading session schedule and trading calendar

security-list — overnight-eligible securities by market

participants — market maker broker IDs and names

subscriptions — active real-time WebSocket subscriptions

ah-premium — A/H premium ratio for dual-listed stocks

trade-stats — price distribution by volume (intraday profile)

market-status — market open/close status for each exchange

exchange-rate — exchange rates for all supported currencies

ipo — IPO commands: calendar, subscriptions, us-subscriptions, orders, profit-loss

Auth requirements

• quote, depth, brokers, trades, intraday, kline, static, calc-index, capital, market-temp, trading, security-list, participants, ah-premium, trade-stats, market-status, exchange-rate, ipo calendar/subscriptions/us-subscriptions: Public — no login required
• subscriptions: Requires active session token
• ipo orders, ipo profit-loss: 🔐 Requires longbridge auth login (Trade permission)

Frameworks

ADR Premium Analysis

Cross-market pricing between US ADR, HK H-share, and A-shares. See [references/adr-premium.md](https://github.com/longbridge/skills/tree/main/skills/longbridge-market-data/references/adr-premium.md).

FX Carry Trade

Carry trade opportunity analysis using spot rates, forward points, and interest rate differentials. See [references/fx-carry.md](https://github.com/longbridge/skills/tree/main/skills/longbridge-market-data/references/fx-carry.md).

Error handling

| Situation | Response |

|---|---|

| command not found: longbridge | Install longbridge-terminal: brew tap longbridge/tap && brew install longbridge/tap/longbridge-terminal |

| not logged in / unauthorized | Run longbridge auth login |

| Empty result | "No data returned — verify the symbol format is <CODE>.<MARKET> (e.g. NVDA.US, 700.HK)" |

| Other stderr | Summarize the error after removing tokens/account identifiers — do not retry silently |

MCP fallback

If longbridge is unavailable, discover tools on an already configured Longbridge MCP connection and check equivalent read capability. Do not assume every command has a counterpart: subscriptions is CLI-session-only. Missing tools are an availability limitation, not authority to configure a new service.

Related skills

| User wants | Use |

|---|---|

| Technical analysis (Ichimoku / SMC / Turtle) | longbridge-technical |

| Options or warrants | longbridge-derivatives |

| Financial statements / fundamentals | longbridge-fundamentals |

| Analyst ratings / institutional data | longbridge-research |

| Morning briefing / sector rotation / ETF | longbridge-intel |

File layout

longbridge-market-data/
├── SKILL.md
└── references/
    ├── quote.md · kline.md · depth.md · trades.md · intraday.md
    ├── capital.md · market-temp.md · trading.md · security-list.md
    ├── participants.md · subscriptions.md · ah-premium.md
    ├── trade-stats.md · market-status.md · exchange-rate.md
    ├── ipo.md · adr-premium.md · fx-carry.md

Data checks and example

For a request such as “compare the ADR and Hong Kong listing”, return instrument identifiers, quote timestamps/time zones, currency, FX direction and timestamp, and verified depositary ratio before computing a common-unit premium. Label delayed, stale, missing and closed-market observations. A price gap is not an executable arbitrage: conversion eligibility, fees, settlement, borrowing and trading-hour overlap matter. Read-only analysis does not authorize IPO orders or trading. Account results are private.

Limitations

• Use this skill only when the task clearly matches its upstream source and local project context.
• Treat all market, trading, instrument, account, or portfolio examples as technical API examples only, not financial advice or a recommendation to trade.

• Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
• Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.