Get the A-share IPO list (with subscript

GET /api/v1.0/quote/ipo-list/cn

Get the A-share IPO list (with subscription, winning and listing info). Data is fetched from the current user's primary broker (broker selection is not exposed); when no broker is available for the CN market for this user, an empty list may be returned. Use request_type to switch between new-notice / applying / apply-result / waiting-to-list (default) / all. list_time is "--" and list_timestamp is 0 when not yet listed. For HK IPOs use quote.ipo_list_hk; US quote.ipo_list_us; Singapore quote.ipo_list_sg; Malaysia quote.ipo_list_my; Japan quote.ipo_list_jp.

Parameters

Name	Type	In	Required	Description
request_type	int	query	no	Request type (CN only): 1=NEW_NOTICE / 2=APPLYING / 3=APPLY_RESULT / 4=WAITING_IPO (default) / 5=ALL

Example

curl 'https://webapi.futunn.com/api/v1.0/quote/ipo-list/cn' | jq

Response

Name	Type	Description
data.code	string	Stock symbol (with market prefix, derived from stock_id), e.g. SH.601077
data.name	string	Stock name (original name for A-share IPO list, may be in English)
data.list_time	string	Listing date string; "--" when not yet listed
data.list_timestamp	int	Listing time, ms timestamp; 0 when not yet listed
data.apply_code	string	Subscription code (channel code for A-share IPO subscription)
data.apply_upper_limit	int	Subscription upper limit (shares)
data.is_estimate_apply_limit	int	Whether the subscription upper limit is an estimate
data.is_estimate_ipo_price	int	Whether the offer price is an estimate
data.ipo_price	number	Offer price (CNY); 0 if non-numeric or missing
data.is_estimate_winning_ratio	int	Whether the winning ratio is an estimate
data.winning_ratio	number	Winning ratio (percentage)
data.issue_pe_rate	number	Issue PE ratio
data.apply_time	int	Subscription date, ms timestamp (UTC ms of Beijing local midnight)
data.apply_timestamp	int	Subscription time, ms timestamp (same semantics as apply_time)
data.winning_time	string	Winning announcement date string, format yyyy-MM-dd
data.winning_timestamp	int	Winning announcement time, ms timestamp
data.is_has_won	int	Whether the winning announcement has started

Errors

ret_code	error.code	When
0	—	Success
-3	invalid_parameter	A parameter is missing or not in the allowed set
-7	invalid_symbol	Symbol is not in the security master
-8	unsupported	Market or instrument is outside this API
-9	permission_denied	Authenticated, but without quote permission
-10	no_data	Nothing is returned
-11	rate_limited	Per-user rate limit

Response example

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "code": "US.AAPL",
    "name": "example",
    "list_time": "example",
    "list_timestamp": 1710000000000000,
    "apply_code": "example",
    "apply_upper_limit": 0,
    "is_estimate_apply_limit": 0,
    "is_estimate_ipo_price": 0,
    "ipo_price": 1.2,
    "is_estimate_winning_ratio": 0,
    "winning_ratio": 1.2,
    "issue_pe_rate": 1.2,
    "apply_time": 1710000000000000,
    "apply_timestamp": 1710000000000000,
    "winning_time": "example",
    "winning_timestamp": 1710000000000000,
    "is_has_won": 0
  }
}