Skip to content

IPO List

GET /api/v1.0/quote/ipo-list/{market}

Get the new stock IPO list. Supports Hong Kong / US / A-shares / Singapore / Malaysia — five markets, each with a separate endpoint. Returns recent subscribable and upcoming IPOs, excluding historical IPOs.

Endpoints

MarketEndpoint
Hong KongGET /api/v1.0/quote/ipo-list/hk
USGET /api/v1.0/quote/ipo-list/us
A-sharesGET /api/v1.0/quote/ipo-list/cn
SingaporeGET /api/v1.0/quote/ipo-list/sg
MalaysiaGET /api/v1.0/quote/ipo-list/my

Parameters

HK / US / Singapore / Malaysia

NameTypeInRequiredDescription
request_typeintquerynoDefault 11. 9=subscribable / 10=pending listing / 11=upcoming (subscribable + pending listing).

A-shares

NameTypeInRequiredDescription
request_typeintquerynoDefault 4. 1=IPO preview / 2=subscribable / 3=ballot announced / 4=pending listing / 5=all.

Request Example

bash
curl "https://webapi.moomoo.com/api/v1.0/quote/ipo-list/hk?request_type=11" | jq
curl "https://webapi.moomoo.com/api/v1.0/quote/ipo-list/us" | jq
curl "https://webapi.moomoo.com/api/v1.0/quote/ipo-list/cn?request_type=4" | jq
curl "https://webapi.moomoo.com/api/v1.0/quote/ipo-list/sg" | jq
curl "https://webapi.moomoo.com/api/v1.0/quote/ipo-list/my" | jq

Response Fields

Hong Kong

FieldTypeDescription
codestringStock code (with market prefix), e.g. HK.12233.
namestringEnglish name.
sc_namestringSimplified Chinese name.
tc_namestringTraditional Chinese name.
list_timestringListing date yyyy-MM-dd; "--" if unavailable.
list_timestampintListing time, millisecond timestamp; 0 if absent.
ipo_price_minfloatIPO price range lower bound (HKD).
ipo_price_maxfloatIPO price range upper bound (HKD).
list_pricefloatIPO price (actual pricing, HKD).
lot_sizeintShares per lot.
entrance_pricefloatEntrance fee (HKD).
apply_start_timestampintSubscription start time, millisecond timestamp.
apply_end_timestringSubscription deadline date yyyy-MM-dd.
apply_end_timestampintSubscription deadline time, millisecond timestamp.
apply_countdown_secsintSubscription deadline countdown (seconds).
is_apply_startedboolWhether subscription has started.
is_support_applyboolWhether subscription is supported.
is_subscribe_statusboolWhether in subscribable status.
apply_multiplestringSubscription multiple.
lucky_ratiostringOne-lot winning ratio.
win_ratio_msgstringWinning probability description.
lucky_timestringBallot announcement date yyyy-MM-dd.
lucky_timestampintBallot announcement time, millisecond timestamp.
margin_fee_ratiofloatMargin subscription interest rate (%).
margin_fee_ratio_minfloatMinimum margin subscription interest rate (%); defaults to 0.
margin_fee_ratio_maxfloatMaximum margin subscription interest rate (%); defaults to 0.
margin_lever_ratiofloatMargin leverage multiple.
real_margin_lever_ratiofloatActual available margin leverage multiple; defaults to 0.
margin_ratefloatMargin ratio (4 decimal places).
dark_trade_datestringGrey market trading date; defaults to empty string.
dark_trade_timestampintGrey market trading date timestamp (milliseconds); defaults to 0.
dark_trade_periodstringGrey market trading period text, e.g. 16:15~18:30.
dark_trade_start_timestampintGrey market trading start time, millisecond timestamp; defaults to 0.
dark_trade_end_timestampintGrey market trading end time, millisecond timestamp; defaults to 0.
is_support_dark_tradeboolWhether grey market trading is supported.
is_support_intl_placingboolWhether international placing is supported.
show_intl_placing_infoboolWhether to display international placing data to current user.
intl_placing_apply_start_timestampintInternational placing subscription start time, millisecond timestamp; defaults to 0.
intl_placing_apply_end_timestampintInternational placing subscription deadline time, millisecond timestamp; defaults to 0.
intl_placing_apply_limitfloatInternational placing minimum subscription amount (HKD).
intl_placing_apply_limit_strstringInternational placing minimum subscription amount string (with thousands separator).
placing_countdown_secsintInternational placing deadline countdown (seconds); defaults to 0.
offer_typestringIPO offer type: UNSUPPORTED / PUBLIC_OFFER_ONLY / INTERNATIONAL_PLACING_ONLY / PUBLIC_AND_INTER_PLACING.
security_typestringSecurity type: NORMAL / SPAC / HK_IBOND / HK_CLIMATE_BOND / HK_SILVER_BOND / HK_ETF / SG_ETF.
etf_distributorsstringETF distributor company (only for ETF IPOs).
etf_ipo_price_displaystringETF issue price display text (only for ETF IPOs).
apply_statusstringPublic subscription status: NOT_APPLIED / APPLY_PENDING / APPLY_PROCESSING / APPLY_WON / APPLY_LOST.
placing_apply_statusstringInternational placing subscription status (same enum as apply_status).
etf_apply_statusstringETF subscription status (only for ETF IPOs); same enum as apply_status.

US

FieldTypeDescription
codestringStock code (with market prefix), e.g. US.AAPL.
namestringEnglish name.
sc_namestringSimplified Chinese name.
tc_namestringTraditional Chinese name.
list_timestringExpected listing date yyyy-MM-dd.
list_timestampintListing time, millisecond timestamp.
ipo_price_minfloatIPO price range lower bound (USD).
ipo_price_maxfloatIPO price range upper bound (USD).
issue_sizeintIssue size (shares).
apply_limitfloatMinimum subscription amount (USD).
apply_start_timestampintSubscription start time, millisecond timestamp.
apply_end_timestampintSubscription deadline time, millisecond timestamp.
lucky_timestampintExpected ballot announcement time, millisecond timestamp.
stock_statusstringIPO status: PENDING / APPLYING / CLOSED.
is_user_appliedboolWhether current user has subscribed.
offer_typestringIPO offer type (same enum as HK).

A-shares

FieldTypeDescription
codestringStock code (with market prefix), e.g. SZ.300728.
namestringEnglish name.
sc_namestringSimplified Chinese name.
tc_namestringTraditional Chinese name.
list_timestringListing date; "--" if not listed.
list_timestampintListing time, millisecond timestamp; 0 if not listed.
apply_codestringSubscription code.
apply_upper_limitintSubscription upper limit (shares).
ipo_pricefloatIPO price (CNY).
winning_ratiofloatWinning ratio (percentage).
issue_pe_ratefloatIssue P/E ratio.
apply_timestampintSubscription time, millisecond timestamp.
winning_timestringBallot announcement date yyyy-MM-dd.
winning_timestampintBallot announcement time, millisecond timestamp.
is_has_wonboolWhether ballot has been drawn.

Singapore

FieldTypeDescription
codestringStock code (with market prefix), e.g. SG.1V2.
namestringEnglish name.
sc_namestringSimplified Chinese name.
tc_namestringTraditional Chinese name.
list_timestringListing date yyyy-MM-dd.
list_timestampintListing time, millisecond timestamp.
ipo_price_minfloatIPO price range lower bound (SGD).
ipo_price_maxfloatIPO price range upper bound (SGD).
offer_price_displaystringOffer price display text.
issue_size_displaystringIssue size display text.
apply_limitfloatMinimum subscription amount (SGD).
apply_limit_displaystringMinimum subscription amount display text.
market_cap_displaystringMarket cap display text.
fund_amount_displaystringFund raised display text.
industry_displaystringIndustry info display text.
managers_displaystringUnderwriters info display text.
ipo_book_linkstringProspectus link.
security_typestringSecurity type (same enum as HK).
apply_start_timestampintSubscription start time, millisecond timestamp.
apply_end_timestampintSubscription deadline time, millisecond timestamp.
is_subscribe_statusboolWhether in subscribable status.
is_user_appliedboolWhether current user has subscribed.

Malaysia

FieldTypeDescription
codestringStock code (with market prefix), e.g. BMS.MYIPO007.
namestringEnglish name.
sc_namestringSimplified Chinese name.
tc_namestringTraditional Chinese name.
list_timestringListing date yyyy-MM-dd.
list_timestampintListing time, millisecond timestamp.
ipo_pricefloatIPO price (MYR).
issue_sizeintIssue size (shares).
fund_amountfloatTotal funds raised (MYR).
market_capintMarket cap (MYR).
currencystringPricing currency code, e.g. MYR.
managerstringUnderwriter info.
industry_platestringIndustry plate name.
businessstringCompany introduction.
ipo_book_linkstringProspectus link.
security_typestringSecurity type (same enum as HK).
apply_start_timestampintSubscription start time, millisecond timestamp.
apply_end_timestampintSubscription deadline time, millisecond timestamp.
draw_timestampintRetail ballot time, millisecond timestamp.
lucky_timestampintBallot announcement time, millisecond timestamp.
apply_limitfloatMinimum subscription amount (MYR).
is_subscribe_statusboolWhether in subscribable status.
is_user_appliedboolWhether current user has subscribed.
support_leverageboolWhether leveraged subscription is supported.

Supported Markets

  • Five markets with separate endpoints: HK / US / CN / SG / MY.
  • Each market returns a different field set (listed per market's available fields).
  • Data is based on the user's primary broker; if the user has no available broker for a market, an empty list may be returned.
  • A-shares cover SSE (incl. STAR Market) / SZSE (incl. ChiNext) / BSE.

Error Codes

ret_codeerror.codeTrigger ConditionHandling
0--Success.--
-3invalid_parameterrequest_type value is invalid or non-integer.Correct to allowed values per market and retry.
-5internal_errorBackend call failed / timeout.Retry later.

Response Examples

Hong Kong:

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "list": [
      {
        "code": "HK.44445",
        "name": "新股配售test",
        "list_time": "2031-05-30",
        "list_timestamp": 1937836800000,
        "list_price": 25.66,
        "lot_size": 100,
        "entrance_price": 100,
        "ipo_price_min": 0,
        "ipo_price_max": 0,
        "apply_start_timestamp": 1773284220000,
        "apply_end_time": "2026-07-31",
        "apply_end_timestamp": 1785463200000,
        "apply_countdown_secs": 4803989,
        "is_apply_started": true,
        "is_support_apply": true,
        "is_subscribe_status": true,
        "apply_multiple": "To Be Announced",
        "lucky_ratio": "To Be Announced",
        "lucky_time": "2026-08-03",
        "lucky_timestamp": 1785740400000,
        "dark_trade_date": "2026-06-01",
        "dark_trade_timestamp": 1780243200000,
        "is_support_dark_trade": true,
        "offer_type": "PUBLIC_AND_INTER_PLACING",
        "security_type": "NORMAL",
        "apply_status": "NOT_APPLIED",
        "placing_apply_status": "NOT_APPLIED"
      }
    ]
  }
}

US:

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "list": [
      {
        "code": "US.MAYHEDEMO111",
        "name": "mayhedemo111",
        "list_time": "2027-06-30",
        "list_timestamp": 1814328000000,
        "ipo_price_min": 23,
        "ipo_price_max": 56.33,
        "issue_size": 1,
        "apply_limit": 67.6,
        "apply_start_timestamp": 1777849680000,
        "apply_end_timestamp": 1782774480000,
        "lucky_timestamp": 1814310480000,
        "stock_status": "PENDING",
        "is_user_applied": false,
        "offer_type": "PUBLIC_OFFER_ONLY"
      }
    ]
  }
}

A-shares:

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "list": [
      {
        "code": "SZ.300728",
        "name": "Jiangsu CTC Technical Fabrics",
        "list_time": "--",
        "list_timestamp": 0,
        "apply_code": "300728",
        "apply_upper_limit": 12000,
        "ipo_price": 7.11,
        "winning_ratio": 0,
        "issue_pe_rate": 22.97,
        "winning_time": "2017-11-16",
        "winning_timestamp": 1510761600000,
        "is_has_won": false
      }
    ]
  }
}