跳到主要内容

新股发行与认购

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
  • 所有接口返回统一 ApiResponse 信封；时间戳为毫秒级 Unix 时间戳，时区按 Asia/Shanghai。
  • 金额按表中币种提供，比例为小数；合法 null 保留字段键。分页从1开始，实际记录范围以返回值为准。

港股新股递表记录​

GET /api/hk-share/ipo/application-list

MCP Tool：get_hk_share_ipo_application_list

分页查询港股公司递表记录，保留同一公司的重复申请。页码从 1 开始，每页 50 条；总数未知时为 null，以 has_next 判断后续页。

请求参数​

参数类型必需默认值说明
pageinteger否1从1开始的页码

请求示例​

curl 'https://fuyao.aicubes.cn/api/hk-share/ipo/application-list?page=1' \
  -H 'X-api-key: <your-api-key>'

响应示例​

示例中的列表已节选，分页与可用范围按实际响应返回。

{
  "code": 0,
  "message": "success",
  "request_id": "example-request",
  "data": {
    "item": [
      {
        "company_name": "Pinnacle Marine Holdings Ltd",
        "application_date": "2026-10-08"
      }
    ],
    "pagination": {
      "page": 1,
      "size": 50,
      "total": null,
      "has_next": true
    }
  }
}

返回字段​

data 元数据

字段类型说明
itemarray业务记录列表
paginationobject分页对象，包含page、size、total和has_next

data.item[] 字段

字段类型说明
company_namestring递表公司名称
application_datedate | null递表日期

data.pagination 字段

字段类型说明
pageinteger从1开始的页码
sizeinteger本页请求大小
totalinteger | null结果总数；未提供时为null
has_nextboolean是否存在后续页

港股认购与待上市日历​

GET /api/hk-share/ipo/calendar-list

MCP Tool：get_hk_share_ipo_calendar_list

查询港股可认购或待上市列表。issue_code 是发行记录标识，正式证券代码未确定时为 null；价格区间、每手股数与入场费详情由发行详情接口查询。截止日期为公共招股日期。

请求参数​

参数类型必需默认值说明
statusstring是—发行阶段：subscribable/awaiting_listing

请求示例​

curl 'https://fuyao.aicubes.cn/api/hk-share/ipo/calendar-list?status=subscribable' \
  -H 'X-api-key: <your-api-key>'

响应示例​

示例中的列表已节选，分页与可用范围按实际响应返回。

{
  "code": 0,
  "message": "success",
  "request_id": "example-request",
  "data": {
    "status": "subscribable",
    "item": [
      {
        "issue_code": "HK6157",
        "thscode": null,
        "name": "瘦西湖文旅",
        "listing_date": null,
        "issue_price": null,
        "currency": "HKD",
        "subscription_end_date": "2026-10-20",
        "entry_fee": 5121.14,
        "issue_price_text": "3.92-5.07"
      }
    ]
  }
}

返回字段​

data 元数据

字段类型说明
statusenum当前阶段
itemarray业务记录列表

data.item[] 字段

字段类型说明
issue_codestring发行记录标识，保留返回HK前缀等值
thscodestring | null正式代码；尚未确认时为空
namestring发行股票名称
listing_datedate | null上市日期
issue_pricenumber | null已定发行价；可认购仅区间时本字段null；单位：HKD
currencystring | nullHKD
subscription_end_datedate | null公共招股截止日期；不是各券商精确时点
entry_feenumber | null业务返回入场费，不拆解其中费用；单位：HKD
issue_price_textstring | null返回招股价展示文本；不从文本虚构单一发行价

港股新股发行详情​

GET /api/hk-share/ipo/issue-detail

MCP Tool：get_hk_share_ipo_issue_detail

按发行记录标识查询港股招股价格区间、每手股数与入场费。金额币种为港元，区间和费用为空时保留 null，本接口不表示该发行记录当前可认购。

请求参数​

参数类型必需默认值说明
issue_codestring是—日历中的发行记录标识，最多32字符

请求示例​

curl 'https://fuyao.aicubes.cn/api/hk-share/ipo/issue-detail?issue_code=HK2636' \
  -H 'X-api-key: <your-api-key>'

响应示例​

示例中的列表已节选，分页与可用范围按实际响应返回。

{
  "code": 0,
  "message": "success",
  "request_id": "example-request",
  "data": {
    "issue_code": "HK2636",
    "currency": "HKD",
    "issue_price_range": {
      "lower": 35.3,
      "upper": 38.8
    },
    "lot_size": 100,
    "entry_fee": 3919.13
  }
}

返回字段​

data 元数据

字段类型说明
issue_codestring返回发行标识
currencystringHKD
issue_price_rangeobject | null招股价格区间对象，包含可空的lower与upper；单位：HKD
lot_sizeinteger | null每手股数；单位：股
entry_feenumber | null业务返回入场费，不自行按价格/股数推算；单位：HKD

data.issue_price_range 字段

字段类型说明
lowernumber | null报价下界；单位：HKD
uppernumber | null报价上界；单位：HKD