Skip to content

HK IPO Applications ​

GET /api/v1.0/quote/ipo/hk/filings

HK IPO filing list: in process / hearing completed, with prospectus link, profile and sponsors. No personal subscription.

Request ​

ParameterTypeInRequiredDescription
page_sizeintquerynoPage size, default 20, max 50
page_flagstringquerynoStart index, 1 on first page; pass back pagination.page_flag

Example ​

bash
curl -X GET 'https://webapi.futunn.com/api/v1.0/quote/ipo/hk/filings?page_size=1&page_flag=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response ​

FieldTypeDescription
data.itemsobject[]
data.items[].namestringCompany name
data.items[].processintegerStatus: IN_PROCESS or HEARING_COMPLETED
data.items[].process_descstringStatus text
data.items[].apply_datestringApplication/publication date text
data.items[].platestringBoard name
data.items[].prospectus_urlstringProspectus URL
data.items[].profilestringCompany profile
data.items[].sponsorsstringSponsor names
pagination.completedstringTrue when this is the last page
pagination.page_flagstringNext start index

Errors ​

ret_codeerror.codeDescription
0—Success
-3invalid_parameterMissing or invalid parameter
-7invalid_symbolUnknown symbol
-8unsupportedMarket or product is not supported
-9permission_deniedMissing permission
-10no_dataNo data
-11rate_limitedToo many requests

Sample ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "name": "example",
        "process": 0,
        "process_desc": "example",
        "apply_date": "example",
        "plate": "example",
        "prospectus_url": "example"
      }
    ]
  },
  "pagination": {
    "completed": true,
    "page_flag": ""
  }
}