opencode-skills-collection 4.0.68 → 4.0.70

package/bundled-skills/longbridge-research/references/institution-rating.md

@@ -0,0 +1,62 @@
+# institution-rating
+
+```
+Institution rating overview and target price summary
+
+Without a subcommand: returns rating distribution (Strong Buy / Buy / Hold / Underperform / Sell) and the current average target price. Subcommands: detail Example: longbridge institution-rating TSLA.US Example: longbridge institution-rating detail TSLA.US Example: longbridge institution-rating TSLA.US --views Example: longbridge institution-rating TSLA.US --format json
+
+Usage: longbridge institution-rating [OPTIONS] [SYMBOL] [COMMAND]
+
+Commands:
+  detail  Historical institution rating and target price detail
+  help    Print this message or the help of the given subcommand(s)
+
+Arguments:
+  [SYMBOL]
+          Symbol in <CODE>.<MARKET> format. Omit when using a subcommand
+
+Options:
+      --history
+          Show rating history (target price and rating changes over time)
+
+      --views
+          Show monthly buy/hold/sell distribution timeline instead of latest snapshot
+
+      --industry-rank
+          Show industry-wide rating ranking instead of per-symbol summary
+
+      --page <PAGE>
+          Page number for --industry-rank results (default: 1)
+          
+          [default: 1]
+
+      --count <COUNT>
+          Number of records to show (default: 20); applies to --history and --industry-rank
+          
+          [default: 20]
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+          
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge institution-rating --format json
+
+# See all options
+longbridge institution-rating --help
+```

package/bundled-skills/longbridge-research/references/investment-ideas.md

@@ -0,0 +1,69 @@
+# longbridge-investment-ideas
+
+Surfaces actionable investment ideas through a multi-lens screening process: value, momentum, fundamental improvement, and thematic catalysts — outputting a prioritised candidate list with brief rationale for each idea.
+
+## Workflow
+
+1. Clarify parameters with the user if not provided:
+   - **Market**: US / HK / A-share / SG (or multiple)
+   - **Theme / sector** (optional): e.g. AI, EV, healthcare, energy
+   - **Style**: value / growth / momentum / contrarian / short ideas
+2. Fetch the relevant universe (index constituents or sector ETF).
+3. For top candidates, fetch valuation indices and recent 60-day price momentum.
+4. Apply the selected screening lens (see below) to rank candidates.
+5. For top 5–8 ideas, fetch news to validate the narrative.
+6. Output a ranked candidate list with rationale.
+
+## Screening lenses
+
+| Lens                    | Signal                                        | CLI data                                   |
+| ----------------------- | --------------------------------------------- | ------------------------------------------ |
+| Value                   | Low PE / PB vs industry median                | `longbridge industry-valuation`            |
+| Momentum                | Top 60-day price return in universe           | `longbridge kline --period day --count 60` |
+| Fundamental improvement | Revenue acceleration / margin expansion (QoQ) | `longbridge financial-report --kind IS`    |
+| Thematic                | Recent policy / product catalyst in news      | `longbridge news`                          |
+
+## CLI
+
+> If you're unsure of exact flag names or defaults, run `longbridge <subcommand> --help` first.
+
+```bash
+# Fetch universe (index constituents)
+longbridge constituent <INDEX_SYMBOL> --format json
+
+# Valuation indices for screening (PE, PB, momentum)
+longbridge calc-index <SYMBOL> --format json
+
+# 60-day daily price for momentum calculation
+longbridge kline <SYMBOL> --period day --count 60 --format json
+
+# News for narrative validation
+longbridge news <SYMBOL> --format json
+```
+
+## Output
+
+**Screening parameters**: market, theme, style lens, date
+
+**Idea candidate table**:
+
+| Rank | Symbol  | Company | Market Cap | Lens                | Key Signal                  | Rationale |
+| ---- | ------- | ------- | ---------- | ------------------- | --------------------------- | --------- |
+| 1    | NVDA.US | NVIDIA  | $2.5T      | Momentum + Thematic | +40% in 60d; AI capex cycle | ...       |
+
+For each top idea, add a one-paragraph 分析摘要 / Analysis summary covering:
+
+- 近期催化剂或关注事项 / Recent catalysts or watchpoints（供参考）
+- 关键指标与事件 / Key metrics and events
+- Key risk (one-liner bear case)
+
+> 以上内容仅供参考，不构成投资建议。投资决策请结合自身风险承受能力独立判断。/ The above is for reference only and does not constitute investment advice.
+
+## Error handling
+
+| Situation                        | Simplified Chinese                           | Traditional Chinese / English                                     |
+| -------------------------------- | -------------------------------------------- | ----------------------------------------------------------------- |
+| `command not found: longbridge`  | 回退到 MCP；否则提示安装 longbridge-terminal | 回退到 MCP；否則提示安裝 / Fall back to MCP; prompt to install    |
+| `not logged in` / `unauthorized` | 请运行 `longbridge auth login`               | 請運行 `longbridge auth login` / Run `longbridge auth login`      |
+| No market or theme specified     | 请告知目标市场和投资风格                     | 請告知目標市場和投資風格 / Please specify target market and style |
+| Other stderr                     | 原样展示错误，不重试                         | 原樣展示，不重試 / Surface verbatim, no silent retry              |

package/bundled-skills/longbridge-research/references/investment-proposal.md

@@ -0,0 +1,95 @@
+# longbridge-investment-proposal
+
+Generate a structured investment proposal for a single stock opportunity.
+
+## Workflow
+
+1. Extract the target symbol; normalise to `<CODE>.<MARKET>`.
+2. Gather data in parallel:
+   - Company profile (name, business, employees, founding, IPO date)
+   - Latest financials (revenue, net income, EPS, ROE, gross margin, FCF)
+   - Valuation multiples (PE, PB, EV-EBITDA, PEG)
+   - Analyst consensus (target price, rating distribution)
+   - Recent news and catalysts
+3. Synthesise into the proposal structure below.
+4. Flag data gaps explicitly rather than fabricating figures.
+
+> If unsure of exact flag names, run `longbridge <subcommand> --help` before proceeding.
+
+## CLI
+
+```bash
+# Company profile
+longbridge company <SYMBOL> --format json
+
+# Financial statements
+longbridge financial-report <SYMBOL> --kind ALL --format json
+
+# Valuation multiples
+longbridge valuation <SYMBOL> --format json
+
+# Analyst consensus
+longbridge consensus <SYMBOL> --format json
+
+# Recent news
+longbridge news <SYMBOL> --format json
+```
+
+## Output structure
+
+```
+# Investment Proposal: <Company Name> (<SYMBOL>)
+Date: <today>
+
+## Executive Summary
+One-paragraph verdict: Buy / Hold / Avoid, price target, key thesis.
+
+## Company Overview
+Business description, market, employees, listing date.
+
+## Investment Thesis
+1. <Core point 1>
+2. <Core point 2>
+3. <Core point 3>
+[4–5 if applicable]
+
+## Financial Analysis
+| Metric        | LTM     | YoY Δ |
+|---------------|---------|--------|
+| Revenue       |         |        |
+| Net Income    |         |        |
+| EPS           |         |        |
+| Gross Margin  |         |        |
+| ROE           |         |        |
+| FCF           |         |        |
+
+## Valuation
+| Multiple   | Current | Industry Median | Assessment |
+|------------|---------|-----------------|------------|
+| PE         |         |                 |            |
+| PB         |         |                 |            |
+| EV/EBITDA  |         |                 |            |
+
+Target price rationale and upside / downside.
+
+## Catalysts & Timeline
+- Near-term (0–3 months): ...
+- Medium-term (3–12 months): ...
+
+## Risk Factors
+- <Risk 1>
+- <Risk 2>
+- <Risk 3>
+
+## Position Recommendation
+Suggested entry range, position size, stop-loss level, review trigger.
+```
+
+## Error handling
+
+| Situation                       | 简体回复                                     | 繁體回復                                     | English reply                                             |
+| ------------------------------- | -------------------------------------------- | -------------------------------------------- | --------------------------------------------------------- |
+| Symbol not found                | 未找到该代码，请确认市场和代码格式。         | 找不到該代碼，請確認市場和代碼格式。         | Symbol not found — verify the exchange and ticker.        |
+| Financials unavailable          | 财务数据暂不可用，提案中该部分留空。         | 財務數據暫不可用，提案中該部分留空。         | Financials unavailable — that section will be left blank. |
+| `command not found: longbridge` | 请安装 longbridge-terminal 或通过 MCP 连接。 | 請安裝 longbridge-terminal 或透過 MCP 連線。 | Install longbridge-terminal or connect via MCP.           |
+| `not logged in`                 | 请运行 `longbridge auth login`。             | 請執行 `longbridge auth login`。             | Run `longbridge auth login`.                              |

package/bundled-skills/longbridge-research/references/investors.md

@@ -0,0 +1,87 @@
+# longbridge-investors
+
+Prompt-only skill. Provides a **fund-manager–centric** view of SEC 13F filings via the Longbridge CLI — who the biggest players are, what a specific manager holds, and how their portfolio changed quarter over quarter.
+
+## CLI
+
+Run `longbridge investors --help` to verify exact flags before use. Common calls:
+
+```bash
+# Top-50 active fund managers by AUM (includes CIK for each)
+longbridge investors --format json
+
+# Full portfolio snapshot for a specific manager
+longbridge investors <CIK> --format json
+longbridge investors 0001067983 --format json    # Berkshire Hathaway (Buffett)
+longbridge investors 0001364742 --format json    # BlackRock
+
+# Limit to top N positions by market value
+longbridge investors <CIK> --top 20 --format json
+
+# Quarter-over-quarter holding changes
+longbridge investors changes <CIK> --format json
+longbridge investors changes 0001067983 --format json
+
+# Help
+longbridge investors --help
+```
+
+Well-known CIKs (verify via the top-50 list first):
+
+| Manager                      | CIK        |
+| ---------------------------- | ---------- |
+| Berkshire Hathaway (Buffett) | 0001067983 |
+| BlackRock                    | 0001364742 |
+
+## Workflow
+
+1. **Identify intent**: ranking → run `investors`; portfolio snapshot → run `investors <CIK>`; changes → run `investors changes <CIK>`.
+2. **Resolve CIK** if not provided: run `longbridge investors --format json` to get the top-50 list and find the matching manager's CIK.
+3. **Fetch data** concurrently where possible.
+4. **Present results**:
+   - Ranking: table of rank / manager name / AUM / CIK.
+   - Portfolio snapshot: table of symbol / shares / market value / % of portfolio; note filing date and reporting period.
+   - Changes: group by action (NEW / ADDED / REDUCED / EXITED); show symbol, shares delta, value delta.
+5. Cite **Longbridge Securities / SEC 13F**; add disclaimer.
+
+## Output
+
+**Ranking** — _Top-50 institutional investors_
+
+```
+Rank | Manager                   | AUM (USD B) | CIK
+  1  | BlackRock                 | 10,200      | 0001364742
+  2  | Vanguard Group            | 8,400       | 0000102909
+  …
+```
+
+**Portfolio snapshot** — _Berkshire Hathaway as of {filing date}_
+
+```
+Symbol     | Shares (M) | Market Value (USD M) | % Portfolio
+AAPL.US    | 905.6      | 174,300              | 47.2%
+BAC.US     | 1,032.8    | 35,100               | 9.5%
+…
+```
+
+**Changes** — _Berkshire Hathaway: Q4 2024 → Q1 2025_
+
+```
+NEW:     OXY.US (+18.9M shares, +$1.1B)
+ADDED:   AAPL.US (+3.2M, +$620M)
+REDUCED: BYD.US (−5.0M, −$280M)
+EXITED:  HPQ.US (−7.2M, −$195M)
+```
+
+⚠️ 13F 数据滞后约 45 天，仅供参考，不构成投资建议。  
+⚠️ 13F 數據滯後約 45 天，僅供參考，不構成投資建議。  
+⚠️ 13F filings lag ~45 days. For reference only. Not investment advice.
+
+## Error handling
+
+| Situation                       | 简体中文回复                                                                | 繁體中文 / English                                                                                                   |
+| ------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `command not found: longbridge` | 回退到 MCP；如也不可用，请安装 longbridge-terminal。                        | 回退到 MCP；如也不可用，請安裝 longbridge-terminal。/ Fall back to MCP; if unavailable, install longbridge-terminal. |
+| `investors` returns empty       | "暂无 13F 数据，CIK 可能有误，请用 `longbridge investors` 列出前50名确认。" | "暫無 13F 數據，請確認 CIK。" / "No 13F data — verify CIK via `longbridge investors`."                               |
+| CIK not found in top-50         | 提示用户运行 `longbridge investors --format json` 获取完整 CIK 列表。       | 提示用戶查看完整 CIK 列表。/ Ask user to run `longbridge investors` for the full CIK list.                           |
+| Other stderr                    | 直接显示原始错误，不静默重试。                                              | 顯示原始錯誤。/ Surface verbatim — do not retry silently.                                                            |

package/bundled-skills/longbridge-research/references/onchain.md

@@ -0,0 +1,70 @@
+# longbridge-onchain
+
+On-chain data analysis framework — MVRV, NVT, SOPR, whale behaviour, TVL, and DEX liquidity.
+
+## Workflow
+
+1. Fetch crypto spot quote and recent price history from Longbridge.
+2. Ask the user to provide on-chain data, or guide them to a public source:
+   - Glassnode: MVRV, NVT, SOPR, active addresses
+   - Dune Analytics: DEX volume, TVL by protocol
+   - Nansen: whale wallet labels and flows
+   - DefiLlama: cross-chain TVL
+3. Interpret the metrics using standard thresholds:
+   - MVRV > 3.0 → historically overheated; < 1.0 → historically undervalued
+   - NVT > 90th percentile → overvalued relative to transaction throughput
+   - SOPR > 1 → holders selling at profit (potential distribution)
+   - SOPR < 1 → holders selling at loss (potential capitulation)
+4. Synthesise a verdict: Undervalued / Fair Value / Overheated / Distribution Zone.
+5. Cross-reference with price trend from Longbridge kline data.
+
+> If unsure of exact flag names, run `longbridge <subcommand> --help` before proceeding.
+
+## CLI
+
+```bash
+# Crypto spot quote
+longbridge quote BTCUSD.HAS --format json
+
+# Recent daily price trend (ETH example); run --help for period/count flags
+longbridge kline ETHUSD.HAS --format json   # run --help for available flags
+```
+
+Supported crypto symbols use the `.HAS` suffix (e.g. `BTCUSD.HAS`, `ETHUSD.HAS`, `SOLUSD.HAS`).
+
+## Output structure
+
+```
+ON-CHAIN ANALYSIS — <TOKEN>  <Date>
+
+PRICE CONTEXT (Longbridge)
+Current: $xx,xxx   7d: +x.x%   30d: +x.x%
+90d Range: $xx,xxx – $xx,xxx
+
+ON-CHAIN METRICS (from <source>)
+MVRV:   x.xx  → [Undervalued | Fair | Overheated]
+NVT:    xxx   → [Low | Normal | High]
+SOPR:   x.xxx → [Accumulation | Neutral | Distribution]
+Active Addresses (7d avg): xxx,xxx
+
+DEFI / TVL (if provided)
+Total TVL: $xxB   7d change: +x.x%
+Top Protocol: <Name>  $xxB
+
+VERDICT
+<2–3 sentence synthesis combining price trend and on-chain signals>
+Signal: [Bullish | Neutral | Bearish | Cautious]
+
+DATA SOURCES
+Price: Longbridge Securities
+On-chain: <Glassnode | Dune | User-supplied>
+```
+
+## Error handling
+
+| Situation                       | 简体回复                                            | 繁體回復                                            | English reply                                                  |
+| ------------------------------- | --------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------------- |
+| Crypto symbol not found         | 请使用 .HAS 后缀格式，如 BTCUSD.HAS。               | 請使用 .HAS 後綴格式，如 BTCUSD.HAS。               | Use the .HAS suffix format, e.g. BTCUSD.HAS.                   |
+| No on-chain data provided       | 链上原始数据请从 Glassnode 或 Dune 获取后提供给我。 | 鏈上原始數據請從 Glassnode 或 Dune 取得後提供給我。 | Please provide on-chain data from Glassnode or Dune Analytics. |
+| `command not found: longbridge` | 请安装 longbridge-terminal 或通过 MCP 连接。        | 請安裝 longbridge-terminal 或透過 MCP 連線。        | Install longbridge-terminal or connect via MCP.                |
+| `not logged in`                 | 请运行 `longbridge auth login`。                    | 請執行 `longbridge auth login`。                    | Run `longbridge auth login`.                                   |

package/bundled-skills/longbridge-research/references/post-investment.md

@@ -0,0 +1,76 @@
+# longbridge-post-investment
+
+Quarterly / monthly post-investment monitoring — track KPIs, flag deviations, and generate action recommendations.
+
+## Workflow
+
+1. Extract symbol(s) from the prompt.
+2. Fetch latest financial results: revenue, gross margin, net income, EPS, FCF.
+3. Fetch analyst consensus for the same period (expected vs actual).
+4. Fetch recent price performance (60 days).
+5. Fetch recent news for qualitative context.
+6. For each KPI: compare actual vs consensus; flag as Beat / In-Line / Miss with magnitude.
+7. Assess price action relative to the fundamental outcome.
+8. Generate monitoring report with action recommendation.
+
+> If unsure of exact flag names, run `longbridge <subcommand> --help` before proceeding.
+
+## CLI
+
+```bash
+# Latest income statement
+longbridge financial-report <SYMBOL> --kind IS --format json
+
+# Analyst consensus (expected vs actual)
+longbridge consensus <SYMBOL> --format json
+
+# Recent news and management commentary
+longbridge news <SYMBOL> --format json
+
+# Price performance (60-day)
+longbridge kline <SYMBOL> --period day --count 60 --format json
+```
+
+## Output structure
+
+```
+# Post-Investment Monitor: <Company> (<SYMBOL>)
+Review date: <today>  Period: <quarter/month>
+
+## KPI Scorecard
+| KPI             | Expected   | Actual     | Δ      | Signal  |
+|-----------------|------------|------------|--------|---------|
+| Revenue         |            |            |        | ✓ Beat  |
+| Gross Margin    |            |            |        | ✗ Miss  |
+| EPS             |            |            |        | ~ In-line |
+| FCF             |            |            |        |         |
+
+## Price Action
+Entry price: $xx.xx  Current: $xx.xx  Return: ±x.x%
+vs market: ±x.x%  vs sector: ±x.x%
+
+## Qualitative Check
+Management tone, guidance revision, key risks materialised / resolved.
+
+## 指标变化摘要 / Key Metrics Update
+
+| 维度 | 预期 | 实际 | 偏差 |
+|---|---|---|---|
+| (根据实际分析填写) | | | |
+
+> 以上内容仅供参考，不构成投资建议。投资决策请结合自身风险承受能力独立判断。
+> The above is for reference only and does not constitute investment advice. Investment decisions should be made based on your own risk tolerance.
+
+Rationale: ...
+Next review trigger: ...
+```
+
+## Error handling
+
+| Situation                       | 简体回复                                     | 繁體回復                                     | English reply                                                           |
+| ------------------------------- | -------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------- |
+| No recent earnings data         | 暂无最新财报数据，无法完成 KPI 对比。        | 暫無最新財報數據，無法完成 KPI 對比。        | No recent earnings data available — KPI comparison cannot be completed. |
+| Consensus data unavailable      | 分析师预期数据不可用，仅展示实际数据。       | 分析師預期數據不可用，僅展示實際數據。       | Consensus data unavailable — showing actuals only.                      |
+| Symbol not found                | 未找到该代码，请确认市场和格式。             | 找不到該代碼，請確認市場和格式。             | Symbol not found — verify the exchange and ticker.                      |
+| `command not found: longbridge` | 请安装 longbridge-terminal 或通过 MCP 连接。 | 請安裝 longbridge-terminal 或透過 MCP 連線。 | Install longbridge-terminal or connect via MCP.                         |
+| `not logged in`                 | 请运行 `longbridge auth login`。             | 請執行 `longbridge auth login`。             | Run `longbridge auth login`.                                            |

package/bundled-skills/longbridge-research/references/shareholder.md

@@ -0,0 +1,72 @@
+# shareholder
+
+```
+Institutional shareholders for a symbol
+
+Without flags: institution list (change direction, sort). --top: Top20 major shareholders across multiple periods (includes individuals and insiders). --object-id: Holding history and trade detail for a specific shareholder (use `object_id` from --top).
+
+Example: longbridge shareholder AAPL.US Example: longbridge shareholder AAPL.US --top Example: longbridge shareholder AAPL.US --object-id 1001 Example: longbridge shareholder AAPL.US --range inc --sort owned
+
+Usage: longbridge shareholder [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --top
+          Show Top20 major shareholders (multi-period, includes individuals and insiders)
+
+      --object-id <ID>
+          Show holding and trade detail for a specific shareholder ID (from --top output)
+
+      --range <RANGE>
+          Filter by change direction: all | inc (increase) | dec (decrease)
+          
+          [default: all]
+
+      --sort <SORT>
+          Sort field: chg (change) | owned (holdings) | time (report date)
+          
+          [default: chg]
+
+      --order <ORDER>
+          Sort order: desc | asc
+          
+          [default: desc]
+
+      --count <COUNT>
+          Max number of institutions to show (default mode)
+          
+          [default: 50]
+
+      --periods <PERIODS>
+          Number of reporting periods to show with --top (default: 1 = Latest only)
+          
+          [default: 1]
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+          
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge shareholder --format json
+
+# See all options
+longbridge shareholder --help
+```

package/bundled-skills/longbridge-research/references/short-positions.md

@@ -0,0 +1,50 @@
+# short-positions
+
+```
+Short selling open interest — undisclosed short positions held over time
+
+Supports US and HK markets; market is inferred from the symbol suffix.
+
+US: bi-weekly FINRA short interest data (`short_interest`, `rate`, `days_to_cover`, `close`). HK: daily HKEX disclosed short positions (`open_short_shares`, `balance`, `cost`, `rate`).
+
+For daily short sale volume (shares sold short each day), use `short-trades`.
+
+Example: longbridge short-positions AAPL.US Example: longbridge short-positions 700.HK
+
+Usage: longbridge short-positions [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format (US or HK, e.g. AAPL.US 700.HK)
+
+Options:
+      --count <COUNT>
+          Number of records to return (1–100, default: 20)
+          
+          [default: 20]
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+          
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge short-positions --format json
+
+# See all options
+longbridge short-positions --help
+```

package/bundled-skills/longbridge-research/references/short-trades.md

@@ -0,0 +1,50 @@
+# short-trades
+
+```
+Daily short sale volume — shares sold short each trading day
+
+Supports US and HK markets; market is inferred from the symbol suffix.
+
+US: FINRA/NASDAQ daily short volume (`nus_amount`, `ny_amount`, `total_amount`, `rate`, `close`). Data source: NASDAQ + NYSE consolidated short sale reports. HK: HKEX daily short sale volume (`amount`, `balance`, `total_amount`, `rate`, `close`). Data source: HKEX daily short selling disclosure.
+
+For total open short interest (cumulative undisclosed positions), use `short-positions`.
+
+Example: longbridge short-trades AAPL.US Example: longbridge short-trades 700.HK
+
+Usage: longbridge short-trades [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format (US or HK, e.g. AAPL.US 700.HK)
+
+Options:
+      --count <COUNT>
+          Number of records to return (1–100, default: 20)
+          
+          [default: 20]
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+          
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge short-trades --format json
+
+# See all options
+longbridge short-trades --help
+```