Get the US IPO list

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

Get the US IPO list. Data is fetched from the current user's primary broker (broker selection is not exposed); when no broker is available for the US market for this user, an empty list may be returned. Use request_type to switch between subscribing / waiting-to-list / upcoming (default). Includes only recent IPOs; dates use yyyy-MM-dd; offer price returns 0 when missing. For HK IPOs use quote.ipo_list_hk; A-shares quote.ipo_list_cn; 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: 9=COMMON_APPLYING / 10=COMMON_WAITING_IPO / 11=COMMON_TO_BE_List (default)

Example

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

Response

Name	Type	Description
data.code	string	Stock symbol (with market prefix), e.g. US.MAYHEDEMO111
data.name	string	Stock name (English name)
data.list_time	string	Expected listing date string, format yyyy-MM-dd
data.list_timestamp	int	Listing time, millisecond timestamp
data.ipo_price_min	number	Lower bound of the IPO offer price range (USD), 0 when missing
data.ipo_price_max	number	Upper bound of the IPO offer price range (USD), 0 when missing
data.issue_size	string	Issue size (shares, integer)
data.apply_limit	number	Minimum subscription amount (USD); only set when subscription is supported
data.apply_start_timestamp	int	Subscription start time, ms timestamp; 0 when missing
data.apply_end_timestamp	int	Subscription deadline, ms timestamp; 0 when missing
data.lucky_timestamp	int	Expected winning announcement time, ms timestamp; 0 when missing
data.stock_status	int	Stock status: PENDING / APPLYING / CLOSED
data.is_user_applied	int	Whether the current user has subscribed to the public offering
data.offer_type	int	Offer type: UNSUPPORTED / PUBLIC_OFFER_ONLY / INTERNATIONAL_PLACING_ONLY / PUBLIC_AND_INTER_PLACING
data.placing_apply_limit	number	International placing minimum subscription amount (USD); only set when supported and the user has permission
data.placing_apply_start_timestamp	int	International placing subscription start time, ms timestamp; 0 when missing
data.placing_apply_end_timestamp	int	International placing subscription deadline, ms timestamp; 0 when missing
data.placing_user_has_permission	int	Whether the current user has international placing permission (when placing is open)
data.is_placing_user_applied	int	Whether the current user has subscribed to international placing

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,
    "ipo_price_min": 1.2,
    "ipo_price_max": 1.2,
    "issue_size": "example",
    "apply_limit": 1.2,
    "apply_start_timestamp": 1710000000000000,
    "apply_end_timestamp": 1710000000000000,
    "lucky_timestamp": 1710000000000000,
    "stock_status": 0,
    "is_user_applied": 0,
    "offer_type": 0,
    "placing_apply_limit": 1.2,
    "placing_apply_start_timestamp": 1710000000000000,
    "placing_apply_end_timestamp": 1710000000000000,
    "placing_user_has_permission": 0,
    "is_placing_user_applied": 0
  }
}