跳到主要內容

获取标的经纪队列

该接口用于获取标的的实时经纪队列数据。

SDK Links

Python
longport.openapi.QuoteContext.brokers
Rust
longport::quote::QuoteContext#brokers
Go
QuoteContext.Brokers
Node.js
QuoteContext#brokers
信息

Request

Parameters

NameTypeRequiredDescription
symbolstring标的代码,使用 ticker.region 格式,例如: 700.HK

Protobuf

message SecurityRequest {
string symbol = 1;
}

Request Example

# Get Security Brokers
# https://open.longportapp.com/docs/quote/pull/brokers
# 运行前请访问“开发者中心”确保账户有正确的行情权限。
# 如没有开通行情权限,可以通过“LongPort”手机客户端,并进入“我的 - 我的行情 - 行情商城”购买开通行情权限。
from longport.openapi import QuoteContext, Config

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

resp = ctx.brokers("700.HK")
print(resp)

Response

Response Properties

NameTypeDescription
symbolstring标的代码
ask_brokersobject[]卖盘经纪队列
∟ positionint32档位
∟ broker_idsint32[]券商席位 ID,通过获取券商席位 ID 接口获取
bid_brokersobject[]买盘经纪队列
∟ positionint32档位
∟ broker_idsint32[]券商席位 ID,通过获取券商席位 ID 接口获取

Protobuf

message SecurityBrokersResponse {
string symbol = 1;
repeated Brokers ask_brokers = 2;
repeated Brokers bid_brokers = 3;
}

message Brokers {
int32 position = 1;
repeated int32 broker_ids = 2;
}

Response JSON Example

{
"symbol": "700.HK",
"ask_brokers": [
{
"position": 1,
"broker_ids": [7358, 9057, 9028, 7364]
},
{
"position": 2,
"broker_ids": [6968, 3448, 3348, 1049, 4973, 6997, 3448, 5465, 6997]
}
],
"bid_brokers": [
{
"position": 1,
"broker_ids": [6996, 5465, 8026, 8304, 4978]
},
{
"position": 2
}
]
}

错误码

协议错误码业务错误码描述排查建议
3301600无效的请求请求参数有误或解包失败
3301606限流降低请求频次
7301602服务端内部错误请重试或联系技术人员处理
7301600请求标的不存在检查请求的 symbol 是否正确
7301603标的无行情标的没有请求的行情数据
7301604无权限没有获取标的行情的权限