Skip to content

股票基本信息 ​

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

批量獲取股票/ETF/期權/期貨/窩輪等標的的基本靜態信息。

請求參數 ​

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

請求示例 ​

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

響應字段 ​

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

參數類型説明
dataobject
data.basic_listobject[]
data.basic_list[].codestring股票代碼,例: HK.00700
data.basic_list[].namestring股票英文名,例: TENCENT
data.basic_list[].sc_namestring股票簡體中文名,例: 騰訊控股
data.basic_list[].tc_namestring股票繁體中文名,例: 騰訊控股
data.basic_list[].lot_sizeint每手股數(期權=合約股數,期貨=合約乘數),例: 100
data.basic_list[].stock_typestring股票類型,例: STOCK / ETF / WARRANT / DRVT / FUTURE / IDX
data.basic_list[].exchangestring交易交易所,例: SEHK / US / SSE / HKEX
data.basic_list[].listing_dateint上市時間,毫秒時間戳,例: 1087315200000
data.basic_list[].stock_idint股票 ID(數值標識),例: 54047868453564
data.basic_list[].suspensionbool是否停牌(僅停牌位,完整生命週期見 state 字段),例: false
data.basic_list[].statestring證券生命週期狀態,例: NORMAL / SUSPENDED / DELISTED / EXPIRED / CIRCUIT_BREAKER_RECOVERABLE /...
data.basic_list[].contract_sizeint期權合約股數(每張合約對應正股數量),僅期權品類有值,其它品類為 null
data.basic_list[].main_contractbool是否主連合約(期貨),例: false
data.basic_list[].stock_child_typestring窩輪子類型,例: N/A / CALL / PUT / BULL / BEAR / INLINE
data.basic_list[].stock_ownerstring正股代碼(窩輪/期權對應的標的股),例: HK.00700;非衍生品時為空
paginationobject部分接口返回分頁信息

限制範圍 ​

  • code 必須是已開通行情前綴必須落在已註冊市場前綴內,否則返回 invalid_symbol(如 HK / US / SH / SZ / SG / JP / AU / CA / MY / KR / FX / CC / BMD / SGX / HKEX 等)。
  • 支持的品類:正股 / ETF / 指數 / 窩輪 / 期權 / 期貨 / 債券 / 財富管理基金 / 外匯 / 宏觀數據等。

錯誤碼 ​

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

響應示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "basic_list": [
      {
        "code": "HK.00700",
        "name": "TENCENT",
        "sc_name": "腾讯控股",
        "tc_name": "騰訊控股",
        "lot_size": 100,
        "stock_type": "STOCK",
        "exchange": "SEHK",
        "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",
        "exchange": "SEHK",
        "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",
        "exchange": "BMD",
        "listing_date": 0,
        "stock_id": 75000067,
        "suspension": false,
        "state": "NORMAL",
        "contract_size": 0,
        "main_contract": false,
        "stock_child_type": "N/A"
      }
    ]
  }
}