获取自选股

GET /v1/quote/user-security

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

请求参数

参数	类型	位置	必填	说明
group_name	string	查询	是	自选分组名称（需 URL 编码），最长 100 字符。分组名可由 user-security-group 获取。
X-Futu-Client-Nnid	string	请求头	是	用户身份（牛牛号）。

请求示例

curl -G "$ip/v1/quote/user-security" \
  --data-urlencode 'group_name=美股期权' \
  -H 'X-Futu-Client-Nnid: 99034182' | jq

响应字段

字段	类型	说明
code	string	证券代码，如 US.AAPL。
name	string	证券名称。
lot_size	int	每手股数（期权=合约股数，期货=合约乘数）。
stock_type	string	证券类型：STOCK / ETF / WARRANT / IDX / DRVT / FUTURE / FOREX / CRYPTO / BOND 等。
stock_child_type	int	证券子类型数值。
stock_owner	string	标的正股代码；非衍生品为空串。
option_type	string	期权方向：ALL（非期权）/ CALL / PUT。
strike_time	string	期权行权日（yyyy-MM-dd）；非期权为空串。
strike_price	double	期权行权价；非期权为 0。
listing_date	string	上市日期（yyyy-MM-dd）；无则空串。
stock_id	int	证券内部数值 ID。
main_contract	bool	是否期货主连合约；非期货恒 false。
last_trade_time	string	期权/期货最后交易日（yyyy-MM-dd）；不适用为空串。

限制范围

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

错误码

ret_code	error.code	触发条件	处理建议
0	—	成功（空分组返回空数组）。	正常解析 security_list。
-3	invalid_parameter	缺 group_name / 超长(>100) / 分组名不存在。	校验入参；用 user-security-group 确认分组名。
-9	permission_denied	缺 X-Futu-Client-Nnid 鉴权头。	补齐用户身份后重试。
-5	internal_error	网关编排 / 后端 RPC 异常。	重试；持续失败联系服务方。

响应示例

{
  "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": ""
      }
    ]
  }
}