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

API文檔幫助中心指標

概述

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

基礎URL: https://cibo.hk

所有響應均為JSON格式。成功響應包含 "ok": true，錯誤響應包含 ok: false 和錯誤信息。

認證

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

頻率限制

免費層：每IP每分鐘30次請求，每天5,000次

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

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

名稱	類型	必填
`code`	string	是

cURL 示例

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

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

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼
`oversub`	number	否	最終超額認購倍數（>0），省略時使用 cibo 預測的超購倍數（模型中位數 + 孖展統計加權）
`alpha`	number	否	分配手法係數 α ∈ [0,1]，省略時使用模型推薦值
`agent`	string	否	預測 agent（預設 knn_calibrated）

cURL 示例

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 示例

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

股票數據

GET /api/stocks

獲取所有股票基本列表（代碼、名稱、上市日期）

cURL 示例

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

響應示例

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

GET /api/stocks/oversub

批量獲取所有股票的認購倍數與凍結資金（可選 ?year= 按上市年份過濾）

cURL 示例

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

響應示例

{
  "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

獲取首頁股票卡片數據（含近期上市和即將上市分類）

cURL 示例

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

響應示例

{
  "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 示例

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

GET /api/stocks/compare

對比多隻股票，附帶招股書增強字段（市值、綠鞋、上市開支等）

名稱	類型	必填	説明
`codes`	string	是	逗號分隔的股票代碼（最多 10 個），如 01779,01081
`locale`	string	否	語言代碼（預設 zh-CN），影響行業、機制名稱等文字欄位。

cURL 示例

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

響應示例

{
  "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

獲取單隻股票的完整概覽數據（含過戶處配發結果畫像、配發摘要、基石投資者、中介機構等）

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872

cURL 示例

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

響應示例

{
  "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

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872

cURL 示例

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

響應示例

{
  "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

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872

cURL 示例

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

響應示例

{
  "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

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872
`locale`	string	否	zh-CN / zh-HK / en，預設 zh-CN

cURL 示例

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

響應示例

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

GET /api/stocks/{code}/announcements

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872
`locale`	string	否	zh-CN / zh-HK / en，預設 zh-CN

cURL 示例

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

響應示例

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

GET /api/stocks/{code}/buyback

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872
`locale`	string	否	zh-CN / zh-HK / en，預設 zh-CN

cURL 示例

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

響應示例

{
  "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

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

名稱	類型	必填	説明
`code`	string	是	5位股票代碼，如 06872
`locale`	string	否	zh-CN / zh-HK / en，預設 zh-CN

cURL 示例

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

響應示例

{
  "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

獲取單隻股票的摘要統計（超額倍數、中籤率、發行價、申購人數等）

名稱	類型	必填	説明
`code`	string	是	5位股票代碼

cURL 示例

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

響應示例

{
  "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

獲取單隻股票的過戶處配發結果畫像數據（地區、性別、年齡分佈）

名稱	類型	必填
`code`	string	是

cURL 示例

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

GET /api/stocks/search

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

名稱	類型	必填
`q`	string	是

cURL 示例

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

入通分析

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

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

cURL 示例

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

GET /api/stocks/batch-inclusion-analysis

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

cURL 示例

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

圖表數據

GET /api/charts/frozen-calendar

獲取凍結資金日曆圖表數據（每日凍結資金、上市股票數）

cURL 示例

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

GET /api/charts/scatter-oversub-pnl

獲取超額認購倍數 vs 首日漲跌幅散點圖數據

cURL 示例

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

GET /api/market-insights

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

cURL 示例

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

Cibo快訊

GET /api/flash-events

獲取IPO快訊/新聞事件流

cURL 示例

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

配發檔位

GET /api/allotment-tiers/{code}

獲取配發檔位詳情（含甲組/乙組分類，各檔位申購人數、中籤率）

名稱	類型	必填
`code`	string	是

cURL 示例

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

響應示例

{
  "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},
    ...
  ]
}

收盤價

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

獲取單隻股票上市首日收盤價

名稱	類型	必填
`code`	string	是

cURL 示例

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

響應示例

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

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

批量獲取多隻股票上市首日收盤價（支持GET和POST）

名稱	類型	必填
`codes`	string	是

cURL 示例

# 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 示例

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

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

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

cURL 示例

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

GET /api/agents

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

cURL 示例

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

跨IPO對比

GET /api/cmp/overview

獲取跨IPO對比概覽數據（多隻股票的關鍵指標並排對比）

cURL 示例

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

社交媒體

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

獲取指定平台的二維碼圖片（PNG格式）

名稱	類型	必填
`platform_id`	string	是

cURL 示例

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

緩存數據（預計算）

以下端點返回預先計算好的聚合統計數據和圖表數據，數據來自數據庫緩存表而非實時計算，響應速度更快。適合外部機器人批量獲取加工後的高價值數據。

GET /api/cache/status

返回所有緩存表的行數和最後更新時間

cURL 示例

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

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

返回單隻股票的完整分析緩存（含配發檔位、人口畫像等預計算結果）

名稱	類型	必填
`code`	string	是

cURL 示例

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

GET /api/cache/cmp

返回跨IPO對比數據緩存（省份分佈、年齡、性別等聚合統計）

cURL 示例

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

GET /api/cache/ab

返回甲尾vs乙頭對比數據緩存（中籤效率、資金效率比率）

cURL 示例

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

GET /api/cache/group-ab

返回甲組/乙組彙總數據緩存（各組申請人數、凍結資金總額）

cURL 示例

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

GET /api/cache/frozen-calendar

返回凍結資金日曆數據緩存（每日凍結資金彙總）

cURL 示例

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

GET /api/cache/scatter

返回散點圖數據緩存（超額倍數 vs 首日漲跌幅）

cURL 示例

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

GET /api/cache/rankings/sponsors

返回保薦人排名緩存（包含各保薦人業績統計）

cURL 示例

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

GET /api/cache/rankings/underwriters

返回承銷商排名緩存

cURL 示例

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

GET /api/cache/rankings/cornerstone

返回基石投資者排名緩存

cURL 示例

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

GET /api/cache/rankings/coinvestment

返回基石投資者共同投資關係網絡數據緩存

cURL 示例

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

GET /api/cache/rankings/stabilizing

返回穩價人排名緩存

cURL 示例

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

跨市場與數據中心

GET /api/stocks/full-market

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

cURL 示例

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

GET /api/hynix/snapshot

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

cURL 示例

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

完整端點參考

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

方法	路徑	認證	說明
`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/homepage`	public	Homepage stock cards: upcoming (prelist) and recently listed stocks with status.
`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.
`POST`	`/api/stocks/{code}/predict/batch`	public	Exact single-point predictions for a batch of (oversub, alpha) pairs in one request. Body: {"points":[{"oversub":300,"alpha":0.5}],"agent":"knn_calibrated"} (<=64 points). (params: points, agent)
`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/rankings/stabilizing`	public	Stabilizing manager (稳价人) institution rankings by IPO involvement.
`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/dual-listing-price/{stock_code}`	public	Dual-listing (A+H / secondary) cross-market price and premium/discount.
`GET`	`/api/stocks/batch-inclusion-analysis`	public	Batch Stock Connect inclusion analysis for all candidate stocks (full data as JSON).
`GET`	`/api/stocks/{code}/inclusion-analysis`	public	Per-stock Stock Connect inclusion analysis across all review periods.
`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/{stock_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 (no pid or internal error messages).
`GET`	`/api/agents`	public	Agent heartbeat status, last run, age and duration (public leaderboard; internal error messages omitted).

Cibo — 港股IPO中籤率預測、中籤畫像與入通分析