IPO Info List

This endpoint retrieves a paginated list of IPO (Initial Public Offering) subscription information, including stock details, pricing, subscription periods, and related fees.

HTTP Request

GET /market/v1/ipos

Request Parameters

Name	Type	Required	Description
page	INT	No	Page number, minimum 1, default is 1.
page_size	INT	No	Number of records per page, default is 10, max limit is 100.
market	ENUM	No	Market code. See supported values in the market enum definition.
product_code	STRING	No	Stock code to filter by specific IPO.

Example cURL Request

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'

Response Fields

Field	Type	Description
id	STRING	Unique subscription ID
market	ENUM	Market code. See supported values in the market enum definition.
product_code	STRING	Stock code
name	STRING	Stock name
name_big5	STRING	Stock name in Traditional Chinese
name_gb	STRING	Stock name in Simplified Chinese
currency	STRING	Subscription currency
industry	STRING	Industry
sponsor	STRING	Sponsor
issued_shares	DECIMAL	Number of issued shares
min_issue_price	DECIMAL	Minimum issue price
max_issue_price	DECIMAL	Maximum issue price
allot_price	DECIMAL	Allotment price
start_time	LONG	Subscription start time (UNIX timestamp)
close_time	LONG	Subscription close time for cash (UNIX timestamp)
margin_close_time	LONG	Subscription close time for margin (UNIX timestamp)
close_time_eipo	LONG	Web subscription close time (UNIX timestamp)
allot_date	LONG	Allotment date (UNIX timestamp)
listing_date	LONG	Listing date (UNIX timestamp)
charge	DECIMAL	Subscription fee
loan_charge	DECIMAL	Margin financing additional fee
max_margin_ratio	DECIMAL	Maximum margin financing loan ratio
other_loan_ratio	DECIMAL	Other allowed loan ratio
waive_web_charge	BOOLEAN	Whether web subscription fee is waived
interest_rate	DECIMAL	Margin loan interest rate
interest_day	INT	Number of interest accrual days
susp_margin_loan	BOOLEAN	Whether margin subscription is allowed
eipo	BOOLEAN	Whether web subscription is enabled
allow_web_cancel	BOOLEAN	Whether web cancellation is allowed
info_url	STRING	IPO prospectus PDF download URL
other_info_url	STRING	Company official website
remark	STRING	Remarks
create_time	LONG	Creation time (UNIX timestamp)
update_time	LONG	Last update time (UNIX timestamp)
quantity_options	ARRAY	Subscription quantity and corresponding amount options

quantity_options fields:

Field	Type	Description
qty	INT	Subscription quantity
amount	DECIMAL	Required amount for the quantity

Successful Response Example

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

Error Example

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