> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reportify.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# IPO Calendar HK

> Retrieve the latest Hong Kong IPO calendar, including subscription periods, listing dates, ipo names, temporary symbols, and current status

## 查询香港股票 IPO 日历

**URL:** `/v1/stock/ipo-calendar-hk`\
**方法:** `POST`\
**描述:** 根据状态查询香港股票 IPO 日历信息。

### 请求参数

| 参数名    | 类型     | 必填 | 描述                                          |
| ------ | ------ | -- | ------------------------------------------- |
| status | string | 是  | IPO 状态：Priced（已定价）、Hearing（聆讯中）、Filing（申请中） |

### 响应参数

| 参数名     | 类型      | 描述       |
| ------- | ------- | -------- |
| status  | integer | HTTP 状态码 |
| code    | integer | 业务状态码    |
| message | string  | 响应消息     |
| data    | object  | 响应数据     |

#### data 对象结构

| 参数名   | 类型    | 描述       |
| ----- | ----- | -------- |
| items | array | IPO 项目列表 |

#### IPO 项目对象结构

| 参数名                | 类型      | 描述               |
| ------------------ | ------- | ---------------- |
| temporary\_symbol  | string  | 临时股票代码           |
| symbol             | string  | 正式股票代码           |
| ipo\_name          | string  | IPO 公司名称         |
| ipo\_date          | string  | IPO 日期（ISO 8601） |
| sortTime           | integer | 排序时间戳（毫秒）        |
| notice\_item\_list | array   | 公告列表             |

#### 公告对象结构

| 参数名                          | 类型     | 描述             |
| ---------------------------- | ------ | -------------- |
| notice\_type                 | string | 公告类型           |
| notice\_date                 | string | 公告日期（ISO 8601） |
| notice\_report\_content\_url | string | 公告文件 URL       |
| notice\_report\_title        | string | 公告标题           |

### 示例代码

#### cURL 示例

```bash theme={null}
curl -X POST "https://api.reportify.cn/v1/stock/ipo-calendar-hk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "Hearing"
  }'
```

#### Python 示例

```python theme={null}
import requests

url = "https://api.reportify.cn/v1/stock/ipo-calendar-hk"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "status": "Hearing"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"状态码: {result['status']}")
print(f"IPO 项目数量: {len(result['data']['items'])}")

for item in result['data']['items']:
    print(f"\n公司: {item['ipo_name']}")
    print(f"股票代码: {item['symbol']}")
    print(f"IPO 日期: {item['ipo_date']}")
    print(f"公告数量: {len(item['notice_item_list'])}")
```

### 响应示例

```json theme={null}
{
  "status": 200,
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "temporary_symbol": "H0062",
        "symbol": "03317",
        "ipo_name": "深圳迅策科技股份有限公司",
        "ipo_date": "2025-12-30T13:00:00+08:00",
        "sortTime": 1767070800000,
        "notice_item_list": [
          {
            "notice_type": "聆讯后资料集或相关材料",
            "notice_date": "2025-12-17T00:00:00+08:00",
            "notice_report_content_url": "https://reportify-1252068037.cos.ap-beijing.myqcloud.com/media/production/H00622881b5846b132d3dac0d32989b264b27.pdf",
            "notice_report_title": "PHIP (1st submission)"
          },
          {
            "notice_type": "聆讯后资料集或相关材料",
            "notice_date": "2025-12-17T00:00:00+08:00",
            "notice_report_content_url": "https://reportify-1252068037.cos.ap-beijing.myqcloud.com/media/production/H0062e6c4073ec55d6b9db37c53793eacdb14.pdf",
            "notice_report_title": "聆讯后资料集（第一次呈交）"
          },
          {
            "notice_type": "申请版本或相关材料",
            "notice_date": "2025-09-22T00:00:00+08:00",
            "notice_report_content_url": "https://reportify-1252068037.cos.ap-beijing.myqcloud.com/media/production/H0062d2544f69b6f576694e857530fa579d11.pdf",
            "notice_report_title": "Application Proof (1st submission)"
          },
          {
            "notice_type": "申请版本或相关材料",
            "notice_date": "2025-09-22T00:00:00+08:00",
            "notice_report_content_url": "https://reportify-1252068037.cos.ap-beijing.myqcloud.com/media/production/H00621e5c66eeb84340b2f246f872647598d8.pdf",
            "notice_report_title": "申请版本（第一次呈交）"
          }
        ]
      }
    ]
  }
}
```

### 注意事项

* **status 参数值**：
  * `Priced` - 已定价的 IPO
  * `Hearing` - 正在聆讯中的 IPO
  * `Filing` - 正在申请中的 IPO
* **时间格式**：所有日期时间字段使用 ISO 8601 格式，包含时区信息
* **sortTime**：毫秒级时间戳，用于排序
* **公告文件**：`notice_report_content_url` 提供 PDF 文件的下载链接


## OpenAPI

````yaml POST /v1/stock/ipo-calendar-hk
openapi: 3.1.0
info:
  title: Reportify API
  version: 1.0.0
  description: API documentation for Reportify's document management and search services.
servers:
  - url: https://api.reportify.cn
    description: Production server
security:
  - BearerAuth: []
paths:
  /v1/stock/ipo-calendar-hk:
    post:
      tags:
        - openapi-stock-tools
      summary: Stock IPO Calendar HK
      description: >-
        Retrieve the latest Hong Kong IPO calendar, including subscription
        periods, listing dates, ipo names, temporary symbols, and current status
      operationId: stock_ipo_calendar_hk_reportify_api_v1_stock_ipo_calendar_hk_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StockIPOCalendarHKInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StockAPIResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    StockIPOCalendarHKInput:
      properties:
        status:
          type: string
          enum:
            - Priced
            - Hearing
            - Filing
          title: Status
          description: 'IPO status: Priced, Hearing, or Filing'
          example: Hearing
      type: object
      required:
        - status
      title: StockIPOCalendarHKInput
      description: Input schema for StockIPOCalendarHKTool
    StockAPIResponse:
      properties:
        status:
          type: integer
          title: Status
          description: HTTP status code
        code:
          type: integer
          title: Code
          description: Response code (0 for success)
        message:
          type: string
          title: Message
          description: Response message
        data:
          type: object
          title: Data
          description: Response data (structure varies by endpoint)
      type: object
      title: StockAPIResponse
      description: Generic response wrapper from stock API
    ErrorResponse:
      properties:
        status:
          type: integer
          title: Status
          description: HTTP status code
        code:
          type: integer
          title: Code
          description: Error code
        message:
          type: string
          title: Message
          description: Error message
      type: object
      title: ErrorResponse
      description: Standard error response
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter your Bearer token

````