CCASS 持股比例分布
GET/api/v1.0/quote/{symbol}/broker-hold-ratio获取港股 CCASS 经纪商/香港结算（港股通南向资金等）当前持股比例分布列表（按持股占比降序）。 返回包含：数据更新时间戳与日期、各经纪商名称（broker_name）、CCASS 经纪商代码（broker_code，如 A00003=沪港通 / A00004=深港通 / C00019=汇丰）及持股占已发行股份比例（hold_ratio，百分数）。 仅支持港股（HK.*）。单家经纪商历史每日持股变动请用 quote.broker_hold_detail；实时十大净买卖席位请用 quote.top_ten_brokers。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 港股代码（路径参数，仅支持 HK.*），例: HK.00700 |
page_size | int | 查询 | 否 | 每页返回经纪商条数，默认 20，范围 1~100 |
page_flag | string | 查询 | 否 | 翻页游标，首页不传或传空串；下一页回传 pagination.page_flag |
请求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/broker-hold-ratio?page_size=1&page_flag=1' \
-H 'Authorization: Bearer <AccessToken>' | jq响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
data.items | object[] | |
data.data_time | integer | CCASS 数据更新时间戳（毫秒） |
data.data_date | integer | CCASS 数据日期 YYYY-MM-DD（香港时区） |
data.items[].broker_code | string | CCASS 经纪商代码，例: C00019 / A00003 / A00004 |
data.items[].broker_name | string | 经纪商名称，例: THE HONGKONG AND SHANGHAI BANKING |
data.items[].hold_ratio | number | 持股占比（百分数，原始值放大 1000 倍，20.35 表示 20.35%） |
pagination.completed | string | 是否已到末页 |
pagination.page_flag | string | 下一页游标 |
错误码
| ret_code | error.code | 说明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 参数缺失或不在允许范围内 |
| -7 | invalid_symbol | 标的不存在 |
| -8 | unsupported | 市场或品类不支持 |
| -9 | permission_denied | 没有对应权限 |
| -10 | no_data | 没有可返回的数据 |
| -11 | rate_limited | 调用过于频繁 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"data_time": "example",
"data_date": "example",
"items": [
{
"broker_code": "example",
"broker_name": "example",
"hold_ratio": "example"
}
]
},
"pagination": {
"completed": true,
"page_flag": ""
}
}