IPO 信息列表

此端點用於查詢 IPO（首次公開發行）認購資訊的分頁列表，包括股票詳情、定價、認購期間及相關費用。

HTTP 請求

GET /market/v1/ipos

請求參數

參數名稱	類型	是否必填	說明
page	INT	否	頁碼，最小為 1，預設為 1。
page_size	INT	否	每頁返回記錄數，預設為 10，上限 100。
market	ENUM	否	市場代碼。詳見 market 列舉定義中支援的值。
product_code	STRING	否	股票代碼，用於篩選特定 IPO。

cURL 請求範例

curl --location --request GET '{$base_url}/market/v1/ipos?page=1&page_size=10&market=hkex' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003'

回應欄位

欄位名稱	類型	說明
id	STRING	認購唯一編碼
market	ENUM	市場代碼。詳見 market 列舉定義中支援的值。
product_code	STRING	股票代碼
name	STRING	股票名稱
name_big5	STRING	繁體中文名稱
name_gb	STRING	簡體中文名稱
currency	STRING	認購幣種
industry	STRING	行業
sponsor	STRING	保薦人
issued_shares	DECIMAL	發行股數
min_issue_price	DECIMAL	最低發行價格
max_issue_price	DECIMAL	最高發行價格
allot_price	DECIMAL	分配價格
start_time	LONG	認購開始時間（UNIX 時間戳）
close_time	LONG	認購截止時間 - 現金（UNIX 時間戳）
margin_close_time	LONG	認購截止時間 - 保證金（UNIX 時間戳）
close_time_eipo	LONG	Web 端認購截止時間（UNIX 時間戳）
allot_date	LONG	分配日期（UNIX 時間戳）
listing_date	LONG	上市日期（UNIX 時間戳）
charge	DECIMAL	認購費用
loan_charge	DECIMAL	保證金融資附加手續費
max_margin_ratio	DECIMAL	最大保證金融資貸款比率
other_loan_ratio	DECIMAL	其他允許貸款比率
waive_web_charge	BOOLEAN	是否減免 Web 端認購費用
interest_rate	DECIMAL	保證金貸款利率
interest_day	INT	計息天數
susp_margin_loan	BOOLEAN	是否允許保證金認購
eipo	BOOLEAN	是否開啟 Web 端認購
allow_web_cancel	BOOLEAN	是否開放 Web 端撤銷
info_url	STRING	新股資料 PDF 下載地址
other_info_url	STRING	公司官網
remark	STRING	備註
create_time	LONG	建立時間（UNIX 時間戳）
update_time	LONG	更新時間（UNIX 時間戳）
quantity_options	ARRAY	認購數量與對應資金選項

quantity_options 欄位：

欄位名稱	類型	說明
qty	INT	認購數量
amount	DECIMAL	該數量所需資金

成功回應範例

{
  "code": 0,
  "data": {
    "total_records": 1,
    "page": 1,
    "page_size": 10,
    "ipos": [
      {
        "id": "20261110105956-HKEX:09999",
        "market": "hkex",
        "product_code": "09999",
        "name": "EXAMPLE CORP",
        "name_big5": "範例公司",
        "name_gb": "范例公司",
        "currency": "HKD",
        "industry": "Technology",
        "sponsor": "Example Securities",
        "issued_shares": 100000000,
        "min_issue_price": 10.00,
        "max_issue_price": 12.00,
        "allot_price": 0,
        "start_time": 1746774142,
        "close_time": 1747378942,
        "margin_close_time": 1747292542,
        "close_time_eipo": 1747378942,
        "allot_date": 1747983742,
        "listing_date": 1748070142,
        "charge": 50.00,
        "loan_charge": 100.00,
        "max_margin_ratio": 0.9,
        "other_loan_ratio": 0,
        "waive_web_charge": false,
        "interest_rate": 0.038,
        "interest_day": 7,
        "susp_margin_loan": false,
        "eipo": true,
        "allow_web_cancel": true,
        "info_url": "https://example.com/ipo/prospectus.pdf",
        "other_info_url": "https://example.com",
        "remark": "",
        "create_time": 1746774142,
        "update_time": 1746774142,
        "quantity_options": [
          { "qty": 1000, "amount": 12000.00 },
          { "qty": 2000, "amount": 24000.00 }
        ]
      }
    ]
  }
}

錯誤範例

{
  "code": 500,
  "message": "Internal Service Error",
  "details": ""
}