跳到主要內容

订阅行情数据

该接口用于订阅标的行情数据。

信息

业务指令：6

Request​

Parameters​

NameTypeRequiredDescription
symbolstring[]是订阅的标的代码，例如：[700.HK]

校验规则：
每次请求支持传入的标的数量上限是 500 个
每个用户同时订阅标的数量最多为 500
sub_typeint32[]是订阅的数据类型，例如：[1,2]，详见 SubType
is_first_pushbool是订阅后是否立刻进行一次数据推送。( trade 不支持)

Protobuf​

message SubscribeRequest {
  repeated string symbol = 1;
  repeated SubType sub_type = 2;
  bool is_first_push = 3;
}

Request Example​

# 订阅行情数据
# https://open.longportapp.com/docs/quote/subscribe/subscribe
# 订阅行情数据请检查“开发者中心” - “行情权限”是否正确
# https://open.longportapp.com/account
#
# - 港股 - BMP 基础报价，无实时行情推送，无法用 WebSocket 订阅
# - 美股 - LV1 纳斯达克最优报价 (只限 Open API）
#
# 运行前请访问“开发者中心”确保账户有正确的行情权限。
# 如没有开通行情权限，可以通过“LongPort”手机客户端，并进入“我的 - 我的行情 - 行情商城”购买开通行情权限。
from time import sleep
from longport.openapi import QuoteContext, Config, SubType, PushQuote

def on_quote(symbol: str, event: PushQuote):
    print(symbol, event)

config = Config.from_env()
ctx = QuoteContext(config)
ctx.set_on_quote(on_quote)

ctx.subscribe(["700.HK", "AAPL.US"], [SubType.Quote], is_first_push=True)
sleep(30)

Response​

Response Properties​

返回本次请求订阅成功的标的和类型。

NameTypeDescription
sub_listobject[]订阅的数据
∟ symbolstring标的代码
∟ sub_typeint32[]订阅的数据类型，详见：SubType

Protobuf​

message SubscriptionResponse {
  repeated SubTypeList sub_list = 1;
}

message SubTypeList {
  string symbol = 1;
  repeated SubType sub_type = 2;
}

Response JSON Example​

{
  "sub_list": [
    {
      "symbol": "700.HK",
      "sub_type": [1, 2, 3]
    },
    {
      "symbol": "AAPL.US",
      "sub_type": [2]
    }
  ]
}

接口限制​

警告
  • 港股 BMP 行情不支持行情数据推送。

错误码​

协议错误码业务错误码描述排查建议
3301600无效的请求请求参数有误或解包失败
3301606限流降低请求频次
7301602服务端内部错误请重试或联系技术人员处理
7301605订阅数量超出限制取消部分订阅
7301600请求参数有误检查请求的 sub_type