longbridge-ipo

name	longbridge-ipo
description	IPO full-lifecycle management via Longbridge Securities — HK/US IPO calendar, subscription/pending/listed rosters, individual IPO details and timelines, account IPO orders, and P&L analysis. Calendar and stock lists require no login; account order and P&L queries require Trade permission. Triggers: "新股", "IPO", "打新", "新股申购", "新股日历", "IPO日历", "待上市", "认购", "新股盈亏", "上市首日", "打新收益", "新股申購", "新股日曆", "IPO日曆", "認購", "新股盈虧", "new IPO", "IPO calendar", "subscribe IPO", "new listing", "IPO orders", "IPO profit loss", "new stock listing", "upcoming IPO", "grey market".
license	MIT
metadata	{"author":"longbridge","version":"1.0.0","risk_level":"account_read","requires_login":false,"default_install":true,"requires_mcp":false,"tier":"read"}

longbridge-ipo

IPO full-lifecycle hub: browse upcoming and recent IPOs in HK and US markets, view individual IPO details, and query your own IPO orders and profit/loss.

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

When to use

• "近期港股新股", "港股認購中", "HK IPO subscriptions" → longbridge ipo subscriptions
• "待上市新股", "等待上市", "pending listings HK" → longbridge ipo wait-listing
• "最近上市的港股", "近期上市", "recently listed HK" → longbridge ipo listed
• "美股认购", "US IPO subscriptions" → longbridge ipo us-subscriptions
• "美股新上市", "US recent IPOs" → longbridge ipo us-listed
• "IPO 日历", "新股日程", "IPO calendar" → longbridge ipo calendar
• "XXXX.HK 打新详情", "IPO detail" → longbridge ipo detail <SYMBOL>
• "我的打新订单", "我的新股申購記錄", "my IPO orders" → longbridge ipo orders (requires login + Trade)
• "我打新赚了多少", "IPO 盈亏", "IPO profit/loss" → longbridge ipo profit-loss (requires login + Trade)

For general earnings/dividend calendars, defer to longbridge-calendar. For account orders on secondary-market stocks, defer to longbridge-orders.

Workflow

Public data (no login required):

1. Identify the market (HK / US) and the type of list requested.
2. Call the appropriate subcommand with --format json.
3. Render a table sorted by listing date or subscription close date.

Account data (login + Trade permission required):

1. Confirm the user is asking about their own orders or P&L.
2. Check login state — if not logged in, prompt longbridge auth login with Trade scope.
3. Call longbridge ipo orders or longbridge ipo profit-loss.
4. Summarise: total subscribed amount, filled lots, return%, P&L in home currency.

CLI

Run longbridge ipo --help before constructing calls — it is the canonical source for flags and subcommands.

# Public — no login required
longbridge ipo calendar --format json           # Full IPO calendar (all markets)
longbridge ipo subscriptions --format json      # HK IPOs currently open for subscription
longbridge ipo wait-listing --format json       # HK IPOs pending listing
longbridge ipo listed --format json             # HK recently listed IPOs
longbridge ipo us-subscriptions --format json   # US IPOs currently open for subscription
longbridge ipo us-listed --format json          # US recently listed IPOs
longbridge ipo detail <SYMBOL> --format json    # Individual IPO details + timeline

# Account — requires login with Trade permission
longbridge ipo orders --format json             # My IPO subscription orders
longbridge ipo profit-loss --format json        # My IPO P&L analysis

# Always check flags first
longbridge ipo --help

Output

IPO list / calendar — table: symbol / company name / market / price range / subscription open–close / listing date / lot size / status.

IPO detail — structured timeline: announcement → subscription window → allotment → listing date → first-day open/close (if listed). Include: price range, lot size, fundraising size, industry, underwriters.

My orders — table: symbol / company / applied lots / filled lots / applied amount / status / listing date.

P&L analysis — table: symbol / company / filled lots / cost / listing price / current price / return% / P&L amount. Include a summary row for total P&L.

Cite Longbridge Securities as the data source and note the data timestamp.

Error handling

情形	简体回复	繁體回覆 / English reply
command not found: longbridge	请安装 longbridge-terminal	請安裝 longbridge-terminal / Install longbridge-terminal
not logged in / 账户功能未登录	账户功能需要 Trade 权限，请运行 longbridge auth login	請執行 longbridge auth login / Run with Trade permission
detail 找不到新股	找不到该新股，请确认股票代码格式	找不到該新股 / IPO detail not found — verify symbol
结果为空	当前无符合条件的新股	目前無符合條件的新股 / No IPOs match the filter
其他 stderr	原样返回错误，不静默重试	原樣返回 / Surface verbatim, never retry

MCP fallback

When the CLI binary is missing, fall back via the equivalent MCP tool:

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.

If a tool name does not resolve, ask the user to install the CLI.

Related skills

Skill	Why
longbridge-calendar	General earnings / dividend / IPO / macro calendar (lighter IPO view).
longbridge-orders	Secondary-market order history and fills.
longbridge-fundamental	Post-listing fundamentals once the company has reported.
longbridge-quote	Real-time quote for a newly listed stock on its first day.

File layout

longbridge-ipo/
└── SKILL.md          # prompt-only, no scripts/