十大買賣經紀商

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 }
    ]
  }
}