CCASS Holding Ratios

GET /api/v1.0/quote/{symbol}/broker-hold-ratio

Get HK CCASS participant shareholding ratio breakdown for an HK stock (sorted by holding ratio descending). Returns: update timestamp and date, broker_name, broker_code (e.g. A00003=SH-HK Connect, A00004=SZ-HK Connect, C00019=HSBC), and hold_ratio (percent). HK market only. For a single broker's daily holding history use quote.broker_hold_detail; for realtime top-10 net buy/sell brokers use quote.top_ten_brokers.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	HK stock symbol (path param, HK.* only), e.g. HK.00700
page_size	int	query	no	Page size, default 20, range 1~100
page_flag	string	query	no	Pagination cursor; omit on first page, pass back pagination.page_flag for next page

Example

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

Response

Field	Type	Description
data.items	object[]
data.data_time	integer	CCASS data update timestamp in milliseconds
data.data_date	integer	CCASS data date YYYY-MM-DD (HK timezone)
data.items[].broker_code	string	CCASS broker code, e.g. C00019 / A00003 / A00004
data.items[].broker_name	string	Broker name, e.g. THE HONGKONG AND SHANGHAI BANKING
data.items[].hold_ratio	number	Shareholding ratio in percent
pagination.completed	string	True when this is the last page
pagination.page_flag	string	Next page cursor

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "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": ""
  }
}