牛熊證街貨分佈

GET /api/v1.0/quote/{symbol}/cbbc/distribution

獲取港股正股牛熊證街貨分佈。 不傳 date / interval 時，用 basic-info 最新交易日和默認粒度。 count 為離收市價最近的區間個數，默認 10。價格已還原。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	正股代碼（路徑參數），例: HK.00700
date	string	查詢	否	交易日 yyyy-MM-dd；不傳取最新交易日
interval	int	查詢	否	回收價粒度（已還原，如 5 表示 5 港元）。不傳用默認粒度
count	int	查詢	否	離收市價最近的區間個數，默認 10，最大 50

請求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/cbbc/distribution?date=1&interval=1&count=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

參數	類型	說明
data.currency	string	報價貨幣，例: HKD
data.bulls	object	牛證分佈，按回收價區間從高到低
data.bulls[].lower	string	區間下界
data.bulls[].upper	string	區間上界
data.bulls[].shares	integer	區間內相對街貨股數
data.bulls[].variation	integer	街貨變化量
data.bulls[].index_pages	integer	相對期指張數（僅指數正股）
data.bulls[].index_page_variation	integer	相對期指張數變化量（僅指數正股）
data.bulls[].heavy_cargo	integer	是否全局重貨區
data.bulls[].largest_increase	integer	是否全局最多新增區
data.bears	object	熊證分佈，按回收價區間從低到高
data.bears[].lower	string	區間下界
data.bears[].upper	string	區間上界
data.bears[].shares	integer	區間內相對街貨股數
data.bears[].variation	integer	街貨變化量
data.bears[].index_pages	integer	相對期指張數（僅指數正股）
data.bears[].index_page_variation	integer	相對期指張數變化量（僅指數正股）
data.bears[].heavy_cargo	integer	是否全局重貨區
data.bears[].largest_increase	integer	是否全局最多新增區

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的不存在
-8	unsupported	市場或品類不支持
-9	permission_denied	沒有對應權限
-10	no_data	沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "currency": "example",
    "bulls": "example",
    "bears": "example"
  }
}