longbridge__developers/docs/quote/subscribe/subscribe.md

id, title, slug, sidebar_position

id	title	slug	sidebar_position
quote_subscribe	订阅行情数据	subscribe	2

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

:::info

业务指令：6

:::

Request

Parameters

Name	Type	Required	Description
symbol	string[]	是	订阅的标的代码，例如：[00700.HK] 校验规则： 每次请求支持传入的标的数量上限是 500 个 每个用户同时订阅标的数量最多为 500
sub_type	int32[]	是	订阅的数据类型，例如：[1,2]，详见 SubType
is_first_push	bool	是	订阅后是否立刻进行一次数据推送。( trade 不支持)

Protobuf

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

Response

Response Properties

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

Name	Type	Description
sub_list	object[]	订阅的数据
∟ symbol	string	标的代码
∟ sub_type	int32[]	订阅的数据类型，详见：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]
    }
  ]
}

接口限制

:::caution

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

:::

错误码

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