Skip to content

获取自选股 ​

GET /api/v1.0/quote/user-security

获取用户指定自选分组下的证券(自选股)列表,返回每只标的的代码、名称、每手股数、证券类型及衍生品信息。

请求参数 ​

参数类型位置必填说明
group_namestring查询是自选分组名称(需 URL 编码),最长 100 字符。分组名可由 user-security-group 获取。

请求示例 ​

bash
curl -G "https://webapi.futunn.com/api/v1.0/quote/user-security" \
  --data-urlencode 'group_name=美股期权' | jq

响应字段 ​

参数类型说明
dataobject
data.security_listobject[]
data.security_list[].codestring股票代码,例: HK.00019
data.security_list[].namestring英文名,例: Swire Pacific A
data.security_list[].sc_namestring简体中文名,例: 太古股份公司A
data.security_list[].tc_namestring繁体中文名
data.security_list[].lot_sizeint每手股数(期权=合约股数,期货=合约乘数),例: 500
data.security_list[].stock_typestring证券类型,例: STOCK / ETF / WARRANT / DRVT / FUTURE / IDX / BOND
data.security_list[].stock_child_typeint证券子类型数值(证券子类型枚举),例: 3002
data.security_list[].stock_ownerstring标的股代码(窝轮/期权对应正股),例: HK.00700;非衍生品为空字符串
data.security_list[].option_typestring期权类型,取值: ALL / CALL / PUT / UNKNOWN(非期权返回 ALL)
data.security_list[].strike_timestring期权行权日,格式 yyyy-MM-dd,例: 2026-06-29;非期权为空字符串
data.security_list[].strike_pricenumber期权行权价,例: 390.0;非期权为 0
data.security_list[].listing_datestring上市日期字符串,格式 yyyy-MM-dd,例: 1972-11-01;空时返回空串
data.security_list[].stock_idint证券 ID(数值标识),例: 19
data.security_list[].main_contractbool是否期货主连合约,例: false(非期货固定 false)
data.security_list[].last_trade_timestring期权/期货最后交易日,格式 yyyy-MM-dd;不适用时为空字符串
paginationobject部分接口返回分页信息

限制范围 ​

  • 市场:无限制。自选可含 HK / US / 沪深 / JP / SG / AU / MY / CA 等任意市场标的。
  • 品类:无限制。正股 / ETF / 窝轮 / 期权 / 期货 / 指数 / 债券 / 数字货币等均可出现。
  • 空分组返回 security_list 为空数组(合法,非错误)。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功(空分组返回空数组)。正常解析 security_list。
-3invalid_parameter缺 group_name / 超长(>100) / 分组名不存在。校验入参;用 user-security-group 确认分组名。
-9permission_denied用户身份缺失/无效。补齐用户身份后重试。
-5internal_error服务错误重试;持续失败联系服务方。

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "security_list": [
      {
        "code": "US.SPY260526C735000",
        "name": "SPY 260526 735.00C",
        "lot_size": 100,
        "stock_type": "DRVT",
        "stock_child_type": 8002,
        "stock_owner": "US.SPY",
        "option_type": "CALL",
        "strike_time": "2026-05-26",
        "strike_price": 735.0,
        "listing_date": "",
        "stock_id": 507601755,
        "main_contract": false,
        "last_trade_time": ""
      }
    ]
  }
}