longbridge-derivatives

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

longbridge-derivatives

longbridge-derivatives

Options (US / HK) and HK warrants. Underlying-stock quotes belong in
longbridge-quote
.
Response language: match the user's input language — Simplified Chinese / Traditional Chinese / English.
美股/港股期权及港股窝轮服务。标的股票报价请使用
longbridge-quote
响应语言:匹配用户输入语言——简体中文/繁体中文/英文。

Subcommands

子命令

option
and
warrant
are parent commands; each has its own sub-subcommands. Run
longbridge option --help
/
longbridge warrant --help
to see the current sub-subcommand list and their flags.
CLI commandReturns
longbridge option quote <CONTRACT>... --format json
Quote(s) for one or more option contracts (OCC symbols). Includes IV, delta, strike, expiry.
longbridge option chain <UNDERLYING> --format json
Available expiry dates for the underlying.
longbridge option chain <UNDERLYING> --date YYYY-MM-DD --format json
Strikes for a specific expiry — each row gives
call_symbol
and
put_symbol
OCC codes.
longbridge option volume <UNDERLYING> --format json
Real-time call / put volume snapshot (use
longbridge option volume daily ...
for historical).
longbridge warrant <UNDERLYING> --format json
Default warrants list for an underlying (HK only).
longbridge warrant quote <WARRANT>... --format json
Quote(s) for HK warrants (leverage, IV, etc.).
longbridge warrant issuers --format json
Directory of HK warrant issuers.
option
warrant
父命令;各自拥有子子命令。运行
longbridge option --help
/
longbridge warrant --help
查看当前子子命令列表及其参数。
CLI命令返回内容
longbridge option quote <CONTRACT>... --format json
一个或多个期权合约(OCC代码)的报价信息,包括IV、delta、行权价、到期日。
longbridge option chain <UNDERLYING> --format json
标的对应的可用到期日列表。
longbridge option chain <UNDERLYING> --date YYYY-MM-DD --format json
指定到期日的行权价列表——每行包含
call_symbol
put_symbol
的OCC代码。
longbridge option volume <UNDERLYING> --format json
认购/认沽期权实时成交量快照(使用
longbridge option volume daily ...
获取历史数据)。
longbridge warrant <UNDERLYING> --format json
标的对应的默认窝轮列表(仅支持港股)。
longbridge warrant quote <WARRANT>... --format json
港股窝轮报价信息(包括杠杆、IV等)。
longbridge warrant issuers --format json
港股窝轮发行机构名录。

OCC option symbol

OCC期权代码格式

Format:
<TICKER><YYMMDD><C|P><STRIKE×1000, 8 digits>
. Example:
AAPL240119C190000
= AAPL, expires 2024-01-19, Call, strike $190.00.
格式:
<股票代码><YYMMDD><C|P><行权价×1000,8位数字>
。示例:
AAPL240119C190000
= 苹果公司(AAPL),到期日2024-01-19,认购期权(Call),行权价190.00美元。

Two-step option discovery

期权查询两步法

User inputStrategy
Full OCC symbol
option quote <symbol>
directly
Underlying + expiry + strike + call/put
option chain <UL> --date <d>
to find OCC code →
option quote
Underlying + window only
option chain <UL>
to list expiries; ask user to pick
用户输入处理策略
完整OCC代码直接执行
option quote <symbol>
标的+到期日+行权价+认购/认沽先通过
option chain <标的> --date <日期>
查找OCC代码 → 再执行
option quote
仅标的+时间范围
option chain <标的>
列出到期日,询问用户选择

Term mapping

术语对应表

User saysTerm
认购证 / 牛证 / callCall
认沽证 / 熊证 / putPut
行权价 / strikeStrike
到期日 / expiryExpiry
隐含波动率 / IVImplied volatility
用户表述对应术语
认购证 / 牛证 / callCall(认购期权)
认沽证 / 熊证 / putPut(认沽期权)
行权价 / strikeStrike(行权价)
到期日 / expiryExpiry(到期日)
隐含波动率 / IVImplied volatility(隐含波动率)

CLI

CLI示例

bash
longbridge option quote     AAPL250117C190000 AAPL250117P190000  --format json
longbridge option chain     AAPL.US                              --format json
longbridge option chain     AAPL.US --date 2025-01-17            --format json
longbridge option volume    AAPL.US                              --format json
longbridge warrant          700.HK                               --format json
longbridge warrant quote    12345.HK                             --format json
longbridge warrant issuers                                       --format json
bash
longbridge option quote     AAPL250117C190000 AAPL250117P190000  --format json
longbridge option chain     AAPL.US                              --format json
longbridge option chain     AAPL.US --date 2025-01-17            --format json
longbridge option volume    AAPL.US                              --format json
longbridge warrant          700.HK                               --format json
longbridge warrant quote    12345.HK                             --format json
longbridge warrant issuers                                       --format json

Output (per subcommand)

各子命令输出格式

  • option quote
    : array of contract rows (each: IV, delta, strike, expiry, …).
  • option chain
    (no date): array of
    {expiry_date}
    .
  • option chain --date
    : array of
    {strike, call_symbol, put_symbol, standard}
    .
  • option volume
    : real-time call / put volume snapshot.
  • warrant <UNDERLYING>
    : array of warrant rows for that underlying.
  • warrant quote
    : array of quote rows.
  • warrant issuers
    : array of
    {id, name_(cn), name_(en)}
    .
  • option quote
    :合约信息数组(每条包含IV、delta、行权价、到期日等)。
  • option chain
    (无日期参数):
    {expiry_date}
    数组。
  • option chain --date
    {strike, call_symbol, put_symbol, standard}
    数组。
  • option volume
    :认购/认沽期权实时成交量快照。
  • warrant <UNDERLYING>
    :该标的对应的窝轮信息数组(仅港股)。
  • warrant quote
    :窝轮报价信息数组。
  • warrant issuers
    {id, name_(cn), name_(en)}
    数组。

When to clarify

需要澄清的场景

  • Warrant query on a non-HK underlying → tell the user "warrants are HK-only" and route appropriately.
  • Long strike list (>30) → present near-the-money strikes only.
  • IV / Greeks during off-hours → may be a previous-session snapshot; mention this if the user asks for "real-time".
  • 针对非港股标的查询窝轮 → 告知用户“窝轮仅支持港股”并进行相应引导。
  • 行权价列表过长(超过30条)→ 仅展示平值附近的行权价。
  • 非交易时段查询IV/希腊字母 → 数据可能为上一交易日快照;若用户要求“实时”数据,需说明此情况。

MCP fallback

MCP备选方案

CLI subcommandMCP tool
option quote
mcp__longbridge__option_quote
option chain
(no date)
mcp__longbridge__option_chain_expiry_date_list
option chain --date
mcp__longbridge__option_chain_info_by_date
option volume
mcp__longbridge__option_volume
/
mcp__longbridge__option_volume_daily
warrant quote
mcp__longbridge__warrant_quote
warrant <UNDERLYING>
(list)
mcp__longbridge__warrant_list
warrant issuers
mcp__longbridge__warrant_issuers
CLI子命令MCP工具
option quote
mcp__longbridge__option_quote
option chain
(无日期)
mcp__longbridge__option_chain_expiry_date_list
option chain --date
mcp__longbridge__option_chain_info_by_date
option volume
mcp__longbridge__option_volume
/
mcp__longbridge__option_volume_daily
warrant quote
mcp__longbridge__warrant_quote
warrant <UNDERLYING>
(列表)
mcp__longbridge__warrant_list
warrant issuers
mcp__longbridge__warrant_issuers

Error handling

错误处理

If
longbridge
is missing, fall back to MCP. "no quote access" on
option quote
indicates the account lacks the options market-data subscription — surface the message verbatim and tell the user to upgrade quote permissions on Longbridge.
longbridge
不可用, fallback至MCP。
option quote
返回*"no quote access"*表示账户未订阅期权市场数据权限——直接显示该提示信息,并告知用户需在长桥证券升级行情权限。

Related skills

相关技能

  • Underlying quote / static →
    longbridge-quote
  • Underlying candlesticks →
    longbridge-kline
  • Underlying orderbook depth →
    longbridge-depth
  • 标的报价/静态信息 →
    longbridge-quote
  • 标的K线数据 →
    longbridge-kline
  • 标的深度盘口 →
    longbridge-depth

File layout

文件结构

longbridge-derivatives/
└── SKILL.md          # prompt-only, no scripts/
longbridge-derivatives/
└── SKILL.md          # 仅提示文件,无scripts/目录