股票基本資訊

POST /v1/quote/stock-basicinfo

獲取股票的基本靜態資訊。

請求參數

參數	類型	位置	必填	說明
code_list	string[]	請求體	是	股票代碼列表，單次 1~400 個，例 ["HK.00700","US.AAPL"]

請求示例

curl -X POST '$ip/v1/quote/stock-basicinfo' \
  -H 'Content-Type: application/json' \
  -d '{"code_list": ["HK.00700"]}' | jq

響應字段

返回 data.basic_list[]，每元素一份標的檔案。

字段	類型	說明
code	string	股票代碼，例 HK.00700
name	string	股票名稱
lot_size	int	每手股數（期權=合約股數，期貨=合約乘數）
stock_type	string	標的類型，詳見命名詞典 > stock_type
listing_date	int	上市時間，毫秒時間戳；期貨/期權/指數等無上市日時為 0
stock_id	int	內部數值標識
suspension	bool	是否停牌（僅停牌位；完整生命週期見 state）
state	string	證券生命週期狀態，詳見命名詞典 > state
contract_size	int|null	期權合約股數（每張合約對應正股數量），僅期權品類有值，其它品類為 null
main_contract	bool	是否主連合約（期貨）
stock_child_type	string	窩輪子類型，詳見命名詞典 > stock_child_type
stock_owner	string	正股代碼（窩輪/期權對應的標的股），例 HK.00700；非衍生品時不返回

限制範圍

• 支持的市場前綴：HK / US / SH / SZ / SG / JP / AU / CA / MY / FX / CC / BMD / SGX / HKEX 等所有 securitycache 索引的市場。
• 支持的品類：正股 / ETF / 指數 / 窩輪 / 期權 / 期貨 / 債券 / 財富管理基金 / 外匯 / 宏觀數據等。

錯誤碼

ret_code	error.code	觸發條件	處理建議
-3	invalid_parameter	缺 code_list / 元素數 0 / 元素數 > 400	校正請求體後重試
-7	invalid_symbol	code_list 全部代碼均無法解析為已知證券	通過 search 接口確認代碼合法性
0	—	部分代碼無法解析：返回有效代碼的結果，無效代碼靜默跳過	調用方按需對比 code_list 與 data.basic_list[].code 找出無效項
-2	internal_error	後端調用異常	重試或聯繫支持

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "basic_list": [
      {
        "code": "HK.00700",
        "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": "腾讯 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": "原棕榈油期货主连 (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"
      }
    ]
  }
}