Cibo Open API 文档 — 港股IPO数据分析

概述

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

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

名称	类型	必填	说明
`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 示例

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

完整端点参考

由唯一数据源自动生成，列出全部公开端点。

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).