股票基本信息

POST /v1/quote/stock-basicinfo

批量获取股票/ETF/期权/期货/窝轮等标的的基本静态信息。

请求参数

参数	类型	位置	必填	说明
code_list	string[]	请求体	是	股票代码列表，单次 1~400 个，例 ["HK.00700","US.AAPL"]

请求示例

curl -s -X POST "$ip/v1/quote/stock-basicinfo" \
  -H "Content-Type: application/json" \
  -d '{"code_list": ["HK.00700", "HK.TCH260629C390000", "BMD.FCPOmain"]}' | 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"
      }
    ]
  }
}