Cibo Open API 文檔 — 港股IPO數據分析

Overview

cibo 是熊貓證券 CEO JW 借助 AI 編程構建的港股 IPO 數據分析平台，核心能力：① 招股期公開發售超購倍數預測與中籤率預測（支持自訂認購倍數與分配手法係數 α）；② 港股通入通分析（含未上市新股）；③ 中籤結果與中籤人群畫像（地區/國籍/性別/年齡推斷）；④ 配發檔位、甲乙組對比與機構排名；⑤ 披露易數據（回購/增減持/停復牌/財報日曆/董事變動/供股配售）、全市場財務、上市聆訊等。所有接口均為 GET 請求，返回 JSON 格式。

Base URL: https://cibo.hk

All responses are JSON. Successful responses include "ok": true. Errors include ok: false and an error message.

Authentication

所有公開API接口均無需認證，可直接調用。免費層速率限制：每IP每分鐘30次，每天5,000次。

Rate Limits

Free tier: 30 requests per minute per IP, 5,000 per day

MCP 伺服器（AI Agent）

cibo 透過 Model Context Protocol (MCP) 將全站數據暴露為一套工具，AI Agent 可直接調用，覆蓋：超購倍數/中籤率預測、入通分析、中籤畫像、配發檔位、甲乙組對比、機構排名（保薦人/承銷商/基石/穩價人）、凍結資金日曆、市場洞察、Cibo快訊、披露易（回購/增減持/停復牌/財報/董事變動/供股配售）、全市場財務與董事名單、上市聆訊、價格（首日收盤/雙重上市/OHLC）、過戶處分析、港股公司目錄、賽博暢想博客、海力士全景套利、A股ETF資金流、數據中心（宏觀指標/美股公司行為/美股新股）等全部數據能力。

端點: https://cibo.hk/mcp

工具數: 58

客戶端配置:

{
  "mcpServers": {
    "cibo": {"url": "https://cibo.hk/mcp"}
  }
}

預測與配發	`predict_allotment` `subscription_cost` `get_prediction` `get_agent_grid` `get_allotment_tiers` `get_oversub`
股票	`list_stocks` `search_stocks` `get_stock_summary` `get_stock_overview` `get_stock_ccass` `get_allottee_profile` `get_stock_announcements` `get_stock_buyback` `get_stock_disclosure` `get_stock_narrative` `compare_stocks`
入通分析	`get_inclusion_batch` `get_stock_inclusion`
機構排名	`get_sponsor_ranking` `get_underwriter_ranking` `get_cornerstone_ranking` `get_coinvestment_network` `get_stabilizing_ranking`
甲乙組對比	`get_ab_comparison` `get_group_ab`
市場數據	`get_frozen_calendar` `get_market_insights` `get_scatter` `get_cmp_overview`
Cibo快訊	`get_flash_events`
披露易	`get_buyback_ranking` `get_disclosure_interest` `get_suspension_resumption` `get_earnings_calendar` `get_director_changes` `get_corporate_actions`
全市場財務	`get_financial_data` `get_director_roster` `get_listing_hearings`
價格	`get_listing_day_close` `get_dual_listing_price` `get_stock_ohlc`
過戶處	`get_registrar_analysis` `get_registrar_research`
港股公司目錄	`list_hk_companies`
賽博暢想	`get_blog_posts`
海力士全景	`get_hynix_snapshot` `get_hynix_history`
A股ETF	`get_a_share_etf_flow`
數據中心	`get_macro_tags` `get_macro_indicators` `get_macro_indicator_data` `get_us_corp_actions` `get_us_listings`

中籤率預測

GET /api/stocks/{code}/predict

獲取單隻股票的完整中籤率預測數據（默認參數：預測超額倍數與推薦分配係數α）

Name	Type	Required
`code`	string	是

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/predict' | python3 -m json.tool

GET /api/stocks/{code}/predict/custom

自訂參數的中籤率預測：可指定最終超額認購倍數(oversub)與分配手法係數(alpha)，alpha 省略時使用模型推薦的α

Name	Type	Required	Description
`code`	string	是	5位股票代码
`oversub`	number	否	最终超额认购倍数（>0），省略时使用 cibo 预测的超购倍数（模型中位数 + 孖展统计加权）
`alpha`	number	否	分配手法系数 α ∈ [0,1]，省略时使用模型推荐值
`agent`	string	否	预测 agent（默认 knn_calibrated）

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/predict/custom?oversub=300&alpha=0.5' | python3 -m json.tool

GET /api/predict-agent-grid/{code}

獲取多組預測 agent 的中籤率預測矩陣（不同倍數×α組合的期望手數）

cURL Example

curl -s 'https://cibo.hk/api/predict-agent-grid/06872' | python3 -m json.tool

Stock Data

GET /api/stocks

Get basic list of all stocks (code, name, listing date)

cURL Example

curl -s 'https://cibo.hk/api/stocks' | python3 -m json.tool | head -30

Response Example

{
  "ok": true,
  "stocks": [
    {"code": "06872", "name": "丹诺医药", "name_zh": "丹诺医药", "listing_date": 20260522},
    {"code": "03388", "name": "創想三維", "name_zh": "创想三维", "listing_date": 20260529},
    ...
  ]
}

GET /api/stocks/oversub

Batch fetch oversubscription multiple and frozen capital for all stocks (optional ?year= filter)

cURL Example

curl -s 'https://cibo.hk/api/stocks/oversub?year=2026' | python3 -m json.tool | head -40

Response Example

{
  "ok": true,
  "stocks": [
    {"stock_code": "06872", "name": "丹诺医药", "listing_date": 20260522,
     "oversubscription": 178.73, "frozen_bn": 12.34, "offer_price": 5.5,
     "hit_rate": 1.2, "n_applicants": 43120},
    ...
  ],
  "n": 101
}

字段说明

字段	说明
`stock_code`	股票代码（5位）
`name`	股票名称
`listing_date`	上市日期（YYYYMMDD）
`oversubscription`	超额认购倍数
`frozen_bn`	冻结资金（亿港元）
`offer_price`	发行价（港元）
`hit_rate`	一手中签率（%）
`n_applicants`	申购人数

GET /api/stocks/index

Get index page stock card data (with recent and upcoming categories)

cURL Example

curl -s 'https://cibo.hk/api/stocks/index' | python3 -m json.tool | head -50

Response Example

{
  "ok": true,
  "normal": [{"c":"06872","n":"丹诺医药","o":"9015","p":"75.7","d":20260522,"f":178.73,...}],
  "recent": [{"c":"03310","n":"云英谷科技","f":91.73,...}],
  "prelist": [{"c":"03388","n":"創想三維","d":20260529,...}]
}

字段说明

字段	说明
`c`	股票代码（5位）
`n`	股票名称
`o`	超额认购倍数
`p`	发行价（港元）
`d`	上市日期（YYYYMMDD）
`f`	首日涨跌幅（%）
`h`	一手中签率
`m`	发售机制文本
`k`	发售机制 key

GET /api/stocks/homepage

獲取首頁數據（近期上市、即將上市、市場概覽卡片）

cURL Example

curl -s 'https://cibo.hk/api/stocks/homepage' | python3 -m json.tool

GET /api/stocks/compare

Compare multiple stocks with enriched data from prospectus_details (market cap, greenshoe, listing expenses, etc.)

Name	Type	Required	Description
`codes`	string	是	Comma-separated stock codes (max 10), e.g. 01779,01081
`locale`	string	否	Locale code (default: zh-CN). Affects text fields like industry, mechanism names.

cURL Example

curl -s 'https://cibo.hk/api/stocks/compare?codes=01779,01081&locale=zh-CN' | python3 -m json.tool

Response Example

{
  "stocks": [
    {
      "code": "01779", "name": "天辰生物－Ｂ",
      "listing_date": 20260605, "offer_price": 96.06,
      "oversub": 4762.58, "first_day_change": 37.21,
      "applicants_hk_public": 266377, "lot_size": 50,
      "hit_rate": "<1%", "reallocation_zero": true,
      "industry": "生物医药", "mechanism": "机制B",
      "listing_chapter": "第18A章", "market_cap_hkd": 11500000000,
      "raised_amount": 989310000, "greenshoe": true,
      "total_shares_post_ipo": 119740740, "hk_initial_pct": 5.0,
      "listing_expenses_hkd": 88900000,
      "listing_expenses_ratio_pct": 8.99,
      "entry_threshold": 4803, "face_value_cny": 1.0,
      "registration_location": "开曼群岛",
      "listing_method": "发售以供认购",
      "price_upper": 96.06, "price_lower": null
    }, ...
  ],
  "count": 2
}

GET /api/stocks/{code}/overview

Get full overview for a single stock (registrar allotment profile, allotment summary, cornerstone investors, syndicate, etc.)

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/overview' | python3 -m json.tool | head -50

Response Example

{
  "ok": true,
  "data": {
    "code": "06872", "name": "丹诺医药",
    "summary": {"oversubscription": 9015, "hit_rate": 6.0, "price": 75.7, ...},
    "ccass": {"total_holders": 15821, "cn_pct": 63.6, "hk_pct": 35.6, ...},
    "allotment": {"tiers": [...], "lot_size": 50},
    "cornerstone": [...],
    "syndicate": {...},
    "close_price": {...}
  },
  "cmp": {...}
}

GET /api/stocks/{code}/prospectus

獲取單隻股票的招股資訊頁完整數據（招股書詳情、基石投資者、新股財務三大表）

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/prospectus' | python3 -m json.tool

Response Example

{
  "ok": true,
  "code": "06872",
  "prospectus": {"offer_price": 75.7, "mechanism": "机制B", "greenshoe": true,
                 "secondary_listing": false, "global_shares": 100000000,
                 "market_cap_hkd": 11500000000, "listing_expenses_hkd": 88900000, ...},
  "cornerstone": [{"investor_name": "...", "shares_subscribed": 1000000, ...}],
  "financial": {"income": {"periods": [...], "items": [...]},
                "balance": {...}, "cashflow": {...},
                "currency": "CNY", "unit": "thousand"}
}

GET /api/stocks/{code}/allotment-result

獲取單隻股票的配發結果頁完整數據（配發摘要含國際配售與綠鞋、國際配售集中度、基石實際配售與鎖定期、甲乙組檔位）

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/allotment-result' | python3 -m json.tool

Response Example

{
  "ok": true,
  "code": "06872",
  "summary": {"offer_price": 75.7, "oversubscription": 178.73, "frozen_bn": 12.34,
              "hk_public_shares": 10000000, "intl_shares": 90000000,
              "intl_oversubscription": 3.2, "placee_count": 131, "reallocation": "...",
              "greenshoe": true, "hit_rate": 1.2, "n_applicants": 43120, ...},
  "concentration": [{"rank_label": "前5名承配人", "intl_pct": 45.2, "total_pct": 40.1, "shares": ...}],
  "cornerstone": [{"investor_name": "...", "shares": 1000000, "pct_offer": 8.0,
                   "lockup_end_date": 20261122, ...}],
  "tiers": [{"tier_group": "甲组", "applied_shares": 50, "allotment_pct": 1.2, ...}]
}

GET /api/stocks/{code}/allottee-profile

獲取單隻股票的中籤畫像數據（中籤者人群畫像：總手數、自然人數/公司數、地區、性別、年齡分佈金字塔、香港身份證字母/年代/分區）

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872
`locale`	string	否	zh-CN / zh-HK / en，默认 zh-CN

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/allottee-profile' | python3 -m json.tool

Response Example

{
  "ok": true,
  "code": "06872",
  "profile": {"s": {"total": 100000000, "person": ..., "comp": ...},
              "type": [...], "country": [...], "province": [...], "gender": [...],
              "ah": {...}, "py": {...}, "hl": [...], "he": [...], "hd": [...]}
}

GET /api/stocks/{code}/announcements

獲取單隻股票的公告中心數據（全部港交所公告，按標題分類分組，含發佈日期與文件連結）

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872
`locale`	string	否	zh-CN / zh-HK / en，默认 zh-CN

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/announcements' | python3 -m json.tool

Response Example

{
  "ok": true,
  "code": "06872",
  "name": "...",
  "groups": [{"category": "...", "label": "...",
              "announcements": [{"title": "...", "publish_date": 20261122, "file_url": "..."}]}],
  "stats": {"total": 42}
}

GET /api/stocks/{code}/buyback

獲取單隻股票的回購明細（每日回購股數、金額及累計統計）

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872
`locale`	string	否	zh-CN / zh-HK / en，默认 zh-CN

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/buyback' | python3 -m json.tool

Response Example

{
  "ok": true,
  "code": "06872",
  "name": "...",
  "records": [{"date": 20261122, "shares": 500000, "amount": 1234567.0, ...}],
  "stats": {"total_days": 12, "total_shares": 6000000, "total_amount": ...}
}

GET /api/stocks/{code}/disclosure

獲取單隻股票的增減持明細（持有人、身份、事件類型、股數與佔比）

Name	Type	Required	Description
`code`	string	是	5位股票代码，如 06872
`locale`	string	否	zh-CN / zh-HK / en，默认 zh-CN

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/disclosure' | python3 -m json.tool

Response Example

{
  "ok": true,
  "code": "06872",
  "name": "...",
  "items": [{"holder": "...", "capacity": "...", "event_type": "buy",
             "shares_display": "1,000,000", "pct_display": "5.2%", "event_date": 20261122}],
  "stats": {"total": 8, "buy": 5, "sell": 3}
}

GET /api/stocks/{code}/summary

Get summary statistics for a single stock (oversubscription, hit rate, offer price, applicant count, etc.)

Name	Type	Required	Description
`code`	string	是	5位股票代码

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/summary' | python3 -m json.tool

Response Example

{
  "ok": true,
  "s": {
    "oversubscription": 9015,     // 超额认购倍数
    "hit_rate": 6.0,              // 一手中签率(%)
    "price": 75.7,                // 发行价(港元)
    "n_applicants": 275978,       // 申购人数
    "frozen_bn": 5651.3,          // 冻结资金(亿港元)
    "cn_pct": 63.6,               // 内地持有人占比(%)
    "hk_pct": 35.6,               // 香港持有人占比(%)
    "offering_mechanism": "机制B", // 发售机制
    "final_public_pct": 9.35      // 最终公开发售占比(%)
  },
  "tier": {...}                   // 申购档位配发数据
}

GET /api/stocks/{code}/ccass

Get registrar allotment results profile for a single stock (region, gender, age distribution)

Name	Type	Required
`code`	string	是

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/ccass' | python3 -m json.tool | head -30

GET /api/stocks/search

按代碼或名稱搜索股票（支援中英文名）

Name	Type	Required
`q`	string	是

cURL Example

curl -s 'https://cibo.hk/api/stocks/search?q=06872' | python3 -m json.tool

入通分析

GET /api/stocks/{code}/inclusion-analysis

獲取單隻股票的入通（港股通）納入分析

cURL Example

curl -s 'https://cibo.hk/api/stocks/06872/inclusion-analysis' | python3 -m json.tool

GET /api/stocks/batch-inclusion-analysis

批量獲取多隻股票的入通納入分析

cURL Example

curl -s 'https://cibo.hk/api/stocks/batch-inclusion-analysis' | python3 -m json.tool

Chart Data

GET /api/charts/frozen-calendar

Get frozen capital calendar chart data (daily frozen amount, number of IPOs)

cURL Example

curl -s 'https://cibo.hk/api/charts/frozen-calendar' | python3 -m json.tool | head -30

GET /api/charts/scatter-oversub-pnl

Get oversubscription vs first-day P&L scatter chart data

cURL Example

curl -s 'https://cibo.hk/api/charts/scatter-oversub-pnl' | python3 -m json.tool | head -20

GET /api/market-insights

獲取跨IPO市場洞察與聚合分析

cURL Example

curl -s 'https://cibo.hk/api/market-insights' | python3 -m json.tool

Cibo快訊

GET /api/flash-events

獲取IPO快訊/新聞事件流

cURL Example

curl -s 'https://cibo.hk/api/flash-events?locale=zh-CN&limit=50' | python3 -m json.tool

Allotment Tiers

GET /api/allotment-tiers/{code}

Get allotment tier details (Group A/B classification, applicant count, success rate per tier)

Name	Type	Required
`code`	string	是

cURL Example

curl -s 'https://cibo.hk/api/allotment-tiers/06872' | python3 -m json.tool | head -40

Response Example

{
  "ok": true,
  "lot_size": 50,
  "tiers_a": [  // 甲组 (Pool A): 申购金额 ≤5M HKD
    {"applied_shares": 50, "applicant_count": 124567, "winner_count": 7474, "allotment_pct": 6.0},
    ...
  ],
  "tiers_b": [  // 乙组 (Pool B): 申购金额 >5M HKD
    {"applied_shares": 500000, "applicant_count": 1234, "winner_count": 12, "allotment_pct": 0.97},
    ...
  ]
}

Closing Prices

GET /api/listing-day-close-price/{code}

Get listing day closing price for a single stock

Name	Type	Required
`code`	string	是

cURL Example

curl -s 'https://cibo.hk/api/listing-day-close-price/06872'

Response Example

{"ok": true, "code": "06872", "listing_date": 20260522, "listing_day_close_price": 16.2, "source": "hkex"}

GET /api/listing-day-close-prices-batch

Batch get listing day closing prices for multiple stocks (supports GET and POST)

Name	Type	Required
`codes`	string	是

cURL Example

# GET
curl -s 'https://cibo.hk/api/listing-day-close-prices-batch?codes=06872,03310'

# POST
curl -s -X POST 'https://cibo.hk/api/listing-day-close-prices-batch' \
  -H 'Content-Type: application/json' \
  -d '{"codes": ["06872", "03310"]}'

GET /api/stock-ohlc/{code}

獲取單隻股票的日線K線數據（OHLC）

cURL Example

curl -s 'https://cibo.hk/api/stock-ohlc/06872' | python3 -m json.tool

GET /api/dual-listing-price/{stock_code}

獲取雙重上市（A+H等）股票的對岸市場價格

cURL Example

curl -s 'https://cibo.hk/api/dual-listing-price/06872' | python3 -m json.tool

GET /api/agents

獲取數據管道各 agent 的心跳狀態與運行時長

cURL Example

curl -s 'https://cibo.hk/api/agents' | python3 -m json.tool

Cross-IPO Comparison

GET /api/cmp/overview

Get cross-IPO comparison overview (key metrics side-by-side for multiple stocks)

cURL Example

curl -s 'https://cibo.hk/api/cmp/overview' | python3 -m json.tool | head -30

Social Media

GET /api/social-qr/{platform_id}/image

Get QR code image for a specific platform (PNG format)

Name	Type	Required
`platform_id`	string	是

cURL Example

curl -s 'https://cibo.hk/api/social-qr/wechat/image' -o qr.png

Cached Data (Pre-computed)

The following endpoints return pre-computed aggregated statistics and chart data from database cache tables rather than real-time computation, offering faster response times. Ideal for external bots to fetch processed high-value data in bulk.

GET /api/cache/status

Return row counts and last build time for all cache tables

cURL Example

curl -s 'https://cibo.hk/api/cache/status' | python3 -m json.tool

GET /api/cache/stocks/{code}/analysis

Return pre-computed per-stock analysis (allotment tiers, demographics, etc.)

Name	Type	Required
`code`	string	是

cURL Example

curl -s 'https://cibo.hk/api/cache/stocks/02511/analysis' | python3 -m json.tool

GET /api/cache/cmp

Return pre-computed cross-IPO comparison data (province distribution, age, gender, etc.)

cURL Example

curl -s 'https://cibo.hk/api/cache/cmp' | python3 -m json.tool

GET /api/cache/ab

Return pre-computed A-tail vs B-head comparison (lot efficiency, capital efficiency ratios)

cURL Example

curl -s 'https://cibo.hk/api/cache/ab' | python3 -m json.tool

GET /api/cache/group-ab

Return pre-computed Group A/B aggregate data (applicants, frozen funds by group)

cURL Example

curl -s 'https://cibo.hk/api/cache/group-ab' | python3 -m json.tool

GET /api/cache/frozen-calendar

Return pre-computed frozen capital calendar data (daily frozen capital totals)

cURL Example

curl -s 'https://cibo.hk/api/cache/frozen-calendar' | python3 -m json.tool

GET /api/cache/scatter

Return pre-computed scatter plot data (oversubscription vs first-day P&L%)

cURL Example

curl -s 'https://cibo.hk/api/cache/scatter' | python3 -m json.tool

GET /api/cache/rankings/sponsors

Return pre-computed sponsor ranking with performance statistics

cURL Example

curl -s 'https://cibo.hk/api/cache/rankings/sponsors' | python3 -m json.tool

GET /api/cache/rankings/underwriters

Return pre-computed underwriter ranking

cURL Example

curl -s 'https://cibo.hk/api/cache/rankings/underwriters' | python3 -m json.tool

GET /api/cache/rankings/cornerstone

Return pre-computed cornerstone investor ranking

cURL Example

curl -s 'https://cibo.hk/api/cache/rankings/cornerstone' | python3 -m json.tool

GET /api/cache/rankings/coinvestment

Return pre-computed cornerstone co-investment network data

cURL Example

curl -s 'https://cibo.hk/api/cache/rankings/coinvestment' | python3 -m json.tool

GET /api/cache/rankings/stabilizing

返回穩價人排名緩存

cURL Example

curl -s 'https://cibo.hk/api/cache/rankings/stabilizing' | python3 -m json.tool

跨市場與數據中心

GET /api/stocks/full-market

返回全部港股上市公司的目錄（代碼、中英文名、板塊、ISIN），支援 search 關鍵字過濾

cURL Example

curl -s 'https://cibo.hk/api/stocks/full-market?search=&limit=200' | python3 -m json.tool | head -40

GET /api/hynix/snapshot

返回 SK 海力士跨市場套利快照（各標的溢價率、匯率、韓國基準價）

cURL Example

curl -s 'https://cibo.hk/api/hynix/snapshot' | python3 -m json.tool

完整端點參考

由唯一數據源自動生成，列出全部公開端點。

Method	Path	Auth	Description
`GET`	`/api/stocks`	public	List all IPO stocks with basic info (code, name, listing date).
`GET`	`/api/stocks/oversub`	public	Batch oversubscription + frozen capital for all stocks with allotment data. Query: ?year=2026. (params: year)
`GET`	`/api/flash-events`	public	Derived flash-event feed (ipo_launch / allotment_result / listing / inclusion / prediction) as structured JSON for AI crawlers. Query: ?locale=zh-CN&limit=50&stock_code=07688. (params: locale, limit, stock_code)
`GET`	`/api/stocks/index`	public	Stock cards grouped by index with filtering, pagination, search.
`GET`	`/api/stocks/{code}/overview`	public	Full per-stock IPO analysis: subscription rates, allotment tiers, PnL scenarios, CCASS demographics.
`GET`	`/api/stocks/{code}/prospectus`	public	Full prospectus info page data: prospectus details (offer price, mechanism, greenshoe, secondary listing), cornerstone investors, and IPO financial statements.
`GET`	`/api/stocks/{code}/allotment-result`	public	Full allotment results page data: allotment summary (incl. international placing, greenshoe), placing concentration, cornerstone allocation + lock-up, Pool A/B tiers.
`GET`	`/api/stocks/{code}/allottee-profile`	public	中签画像 (allottee profile): winner demographics from the registrar allotment dataset — total lots, person/company split, region/nationality, province, gender, age histogram + pyramid, HK ID letter/era/district.
`GET`	`/api/stocks/{code}/announcements`	public	个股公告中心 (announcement center): all HKEXnews announcements for one stock, grouped by headline category with publish date and file URL.
`GET`	`/api/stocks/{code}/buyback`	public	回购明细 (per-stock buyback): share buyback records for one stock, newest first, with per-day shares/amount and aggregate totals.
`GET`	`/api/stocks/{code}/disclosure`	public	增减持明细 (per-stock disclosure-of-interest): DI records for one stock, newest first, with holder, capacity, event type, shares and pct.
`GET`	`/api/stocks/{code}/summary`	public	Lightweight stock summary: key stats and tier classification.
`GET`	`/api/stocks/{code}/ccass`	public	CCASS custodian demographics: type, province, gender, age distributions.
`GET`	`/api/stocks/{code}/narrative`	public	AI-generated narrative (zh/en) summarizing the IPO's key characteristics.
`GET`	`/api/stocks/compare`	public	Side-by-side comparison of up to 10 stocks. Query: ?codes=00001,00002 (params: codes)
`GET`	`/api/allotment-tiers/{code}`	public	Detailed allotment tier table: Pool A and Pool B subscription tiers with expected lots.
`GET`	`/api/stocks/{code}/predict`	public	Full allotment prediction data (default predicted oversub/alpha) backing the prediction page.
`GET`	`/api/stocks/{code}/predict/custom`	public	On-demand single-point allotment prediction for arbitrary parameters. Query: ?oversub=300&alpha=0.5&agent=knn_calibrated. (params: oversub, alpha, agent)
`GET`	`/api/predict-agent-grid/{code}`	public	Pre-computed prediction grid (18 oversub x 5 alpha) for interpolation.
`GET`	`/api/listing-day-close-price/{code}`	public	First-day closing price for a single stock.
`GET\|POST`	`/api/listing-day-close-prices-batch`	public	Batch first-day closing prices. GET: ?codes=07688,01511 POST: {"codes":[...]}
`GET`	`/api/market-insights`	public	Cross-IPO market insights, trends, and aggregate analysis.
`GET`	`/api/cmp/overview`	public	Cross-market comparison overview for peer stock context.
`GET`	`/api/charts/frozen-calendar`	public	Frozen capital calendar: date series, daily max, regulatory milestones (for index page stacked bar chart).
`GET`	`/api/charts/scatter-oversub-pnl`	public	Oversubscription vs first-day P&L scatter plot data.
`GET`	`/api/cache/rankings/sponsors`	public	Sponsor institution rankings by IPO involvement.
`GET`	`/api/cache/rankings/underwriters`	public	Underwriter institution rankings by IPO involvement.
`GET`	`/api/cache/rankings/cornerstone`	public	Cornerstone investor rankings.
`GET`	`/api/cache/rankings/coinvestment`	public	Co-investment rankings.
`GET`	`/api/cache/stocks/{code}/analysis`	public	Pre-computed per-stock analysis (tier data, demographic distributions, HK letter/era breakdowns).
`GET`	`/api/cache/ab`	public	A-tail vs B-head comparison matrix.
`GET`	`/api/cache/frozen-calendar`	public	Pre-computed frozen capital calendar (dates, series, max_daily).
`GET`	`/api/cache/scatter`	public	Pre-computed scatter plot data (oversubscription vs P&L).
`GET`	`/api/cache/status`	public	Freshness status for all cache tables (row count, last_built timestamp).
`GET`	`/api/blog/posts`	public	List published blog posts with pagination. Query: ?locale=zh-CN&limit=20&offset=0
`GET`	`/api/blog/posts/{slug}`	public	Get a single published blog post by slug.
`GET`	`/api/stocks/full-market`	public	Directory of all HK-listed companies (code, zh/en name, board, isin). Query: ?search=&limit=200. (params: search, limit)
`GET`	`/api/hynix/snapshot`	public	SK Hynix cross-market arbitrage snapshot (instruments with premium_pct, FX rates, base price).
`GET`	`/api/a-share-etf/overview`	public	A-share ETF capital flow overview (merged proxy, ETF inflow, margin). Query: ?limit=60.
`GET`	`/api/user/me`	optional JWT	Current user info from JWT. Returns {user: null} when unauthenticated.
`GET`	`/api/user/watchlist`	pcell JWT	User's watchlist as array of stock codes.
`POST`	`/api/user/watchlist/{code}`	pcell JWT	Toggle a stock in/out of the watchlist. Returns {in_watchlist: bool}.
`GET\|PUT`	`/api/user/preferences`	pcell JWT	Get or update saved user preferences JSON.
`GET`	`/api/`	public	API discovery root: lists all endpoints with methods, auth, and return types.
`GET`	`/.well-known/agent-protocol`	public	Machine-readable agent protocol: service description, auth methods, data categories, recommended agent onboarding flow.
`GET`	`/health`	public	Health check: uptime, DB stats, agent status, cache warmth, pipeline health.
`GET`	`/api/agents`	internal	Internal agent heartbeat status and duration (ops telemetry).

Open API Documentation

Overview

Authentication

Rate Limits

MCP 伺服器（AI Agent）

中籤率預測

Stock Data

入通分析

Chart Data

Cibo快訊

Allotment Tiers

Closing Prices

Cross-IPO Comparison

Social Media

Cached Data (Pre-computed)

跨市場與數據中心

完整端點參考