Longbridge Market Data

---
name: longbridge-market-data
description: "Real-time quotes, K-line charts, order book, trade ticks, intraday capital flow, market sentiment temperature, trading session schedule, security lists, exchange rates, and IPO calendar for HK/US/A-share/SG via Longbridge. Also covers ADR premium and FX carry frameworks."
risk: critical
source: https://github.com/longbridge/skills/tree/main/skills/longbridge-market-data
source_repo: longbridge/skills
source_type: official
date_added: 2026-07-01
license: MIT
license_source: https://github.com/longbridge/skills/blob/main/LICENSE
---
## 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.