十大买卖经纪商

GET /v1/quote/{symbol}/f10/top-brokers

获取港股十大买卖经纪商，分净买入、净卖出两组。提供实时与历史两个维度。

请求参数

实时： /v1/quote/{symbol}/f10/top-brokers

参数	类型	位置	必填	说明
symbol	string	路径	是	港股代码，如 HK.00700。
date	string	查询	否	查询交易日（YYYY-MM-DD）。缺省返回最新交易日。

历史： /v1/quote/{symbol}/f10/top-brokers-history

参数	类型	位置	必填	说明
symbol	string	路径	是	港股代码，如 HK.00700。
days_before	int	查询	是	距当前交易日的天数，范围 1-365。

请求示例

curl "$ip/v1/quote/HK.00700/f10/top-brokers" | jq
curl "$ip/v1/quote/HK.00700/f10/top-brokers-history?days_before=1" | jq

响应字段

字段	类型	说明
is_real_time	bool	true=实时数据，false=历史数据。
data_time	int	数据更新毫秒时间戳。
data_time_str	string	数据更新时间字符串。
sec_volume	int	标的当日总成交量（股，仅实时）。
sec_turnover	float	标的当日总成交额（元，仅实时）。
buy_brokers	array	净买入券商列表（最多 10 条）。
sell_brokers	array	净卖出券商列表（最多 10 条）。
buy_brokers[].net_vol	int	净量（正数）。
buy_brokers[].broker_id	int	经纪商 ID（仅实时）。
buy_brokers[].broker_name	string	经纪商名称（仅历史）。
buy_brokers[].broker_code	string	经纪商代码（仅历史）。
buy_brokers[].hold_ratio	float	持仓占比（%，仅历史）。
buy_brokers[].avg_price	float	成交均价（仅实时）。
sell_brokers[].net_vol	int	净量（负数）。

限制范围

• 市场：仅支持港股（HK）。
• 品类：港股股票类（普通股 / ETF / REIT）；其他品类列表返回空。
• 实时 endpoint 仅在港股交易时段有数据。

错误码

ret_code	error.code	触发条件	处理建议
-3	invalid_parameter	symbol 格式非法 / days_before 越界	校正参数后重试
-7	invalid_symbol	symbol 查不到对应证券	通过 search 接口确认代码合法性
-8	unsupported	非港股市场	仅传港股代码
-2 / -4 / -6	internal_error	网关内部错误	稍后重试，持续失败联系支持

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "is_real_time": false,
    "data_time": 1780588800000,
    "data_time_str": "2026-06-05 00:00:00",
    "buy_brokers": [
      { "broker_code": "C00019", "broker_name": "THE HONGKONG AND SHANGHAI BANKING", "buy_sell_type": 1, "hold_ratio": 32.31, "net_vol": 12289742 },
      { "broker_code": "A00003", "broker_name": "(SH)-HK Stock Connect", "buy_sell_type": 1, "hold_ratio": 6.44, "net_vol": 2586307 }
    ],
    "sell_brokers": [
      { "broker_code": "C00010", "broker_name": "CITIBANK N.A.", "buy_sell_type": 2, "hold_ratio": 7.16, "net_vol": -8557334 },
      { "broker_code": "B01451", "broker_name": "Goldman Sachs", "buy_sell_type": 2, "hold_ratio": 4.01, "net_vol": -2525861 }
    ]
  }
}