Stock Basic Info

POST /api/v1.0/quote/stock-basicinfo

Get basic static information for stocks (listing date, lot size, stock type, etc.).

Parameters

Name	Type	In	Required	Description
code_list	string[]	body	yes	List of symbol codes, 1-400 per request, e.g. ["HK.00700","US.AAPL"]

Request Example

curl -X POST 'https://webapi.moomoo.com/api/v1.0/quote/stock-basicinfo' \
  -H 'Content-Type: application/json' \
  -d '{"code_list": ["HK.00700"]}' | jq

Response Fields

Returns data.basic_list[], one element per symbol profile.

Field	Type	Description
code	string	Symbol code, e.g. HK.00700
name	string	English name
sc_name	string	Simplified Chinese name
tc_name	string	Traditional Chinese name
lot_size	int	Board lot size (for options = contract shares, for futures = contract multiplier)
stock_type	string	Security type. See Naming Dictionary > stock_type
listing_date	int	Listing time, millisecond timestamp; futures/options/indices with no listing date return 0
stock_id	int	Internal numeric identifier
suspension	bool	Whether suspended (suspension flag only; for full lifecycle see state)
state	string	Security lifecycle state. See Naming Dictionary > state
contract_size	int|null	Option contract shares (number of underlying shares per contract); only has value for options, null for other categories
main_contract	bool	Whether this is a continuous (main) contract (futures)
stock_child_type	string	Warrant sub-type. See Naming Dictionary > stock_child_type
stock_owner	string	Underlying stock code (for warrants/options), e.g. HK.00700; not returned for non-derivatives

Supported Markets

• Code must use a supported market prefix from the registered market prefixes; otherwise returns invalid_symbol (e.g. HK / US / SH / SZ / SG / JP / AU / CA / MY / FX / CC / BMD / SGX / HKEX, etc.).
• Supported categories: Stocks / ETFs / Indices / Warrants / Options / Futures / Bonds / Wealth Management Funds / FX / Macro Data, etc.

Error Codes

ret_code	error.code	Trigger Condition	Recommended Action
-3	invalid_parameter	Missing code_list / element count 0 / element count > 400	Correct request body and retry
-7	invalid_symbol	All codes in code_list cannot be resolved to known securities	Use the search API to confirm code validity
0	—	Partial codes unresolvable: returns results for valid codes, invalid codes are silently skipped	Callers should compare code_list with data.basic_list[].code to find invalid entries
-2	internal_error	Backend call exception	Retry or contact support

Response Example

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "basic_list": [
      {
        "code": "HK.00700",
        "name": "TENCENT",
        "sc_name": "腾讯控股",
        "tc_name": "騰訊控股",
        "lot_size": 100,
        "stock_type": "STOCK",
        "listing_date": 1087315200000,
        "stock_id": 54047868453564,
        "suspension": false,
        "state": "NORMAL",
        "contract_size": null,
        "main_contract": false,
        "stock_child_type": "N/A"
      },
      {
        "code": "HK.TCH260629C390000",
        "name": "Tencent 260629 390.00 Call",
        "sc_name": "腾讯 260629 390.00 购",
        "tc_name": "騰訊 260629 390.00 購",
        "lot_size": 100,
        "stock_type": "DRVT",
        "listing_date": 0,
        "stock_id": 81045066,
        "suspension": false,
        "state": "NORMAL",
        "contract_size": 100,
        "main_contract": false,
        "stock_child_type": "N/A",
        "stock_owner": "HK.00700"
      },
      {
        "code": "BMD.FCPOmain",
        "name": "FCPO Main (2608)",
        "sc_name": "原棕榈油期货主连 (2608)",
        "tc_name": "原棕櫚油期貨主連 (2608)",
        "lot_size": 25,
        "stock_type": "FUTURE",
        "listing_date": 0,
        "stock_id": 75000067,
        "suspension": false,
        "state": "NORMAL",
        "contract_size": 0,
        "main_contract": false,
        "stock_child_type": "N/A"
      }
    ]
  }
}