個股籌碼分佈

GET /api/v1.0/quote/{symbol}/chip-distribution

獲取個股籌碼分佈（價格-持倉量直方圖及獲利比例/成本區）。 默認返回查詢日（不傳 date 則當天）1 根日 K 籌碼；count 可向前多取幾日。 價格已還原；獲利比例為百分數；70%/90% 籌碼區間與平均成本一併返回。 主要覆蓋 A 股；無數據時 items 為空數組。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	股票代碼（路徑參數），例: SH.600519 / SZ.000001
date	string	查詢	否	查詢日期 yyyy-MM-dd（按該日 0 點對齊）；不傳取當前
count	int	查詢	否	自 date 向前取多少個週期的籌碼，默認 1，最大 20
ktype	int	查詢	否	K 線週期：1=1分 / 2=日（默認）/ 3=周 / 4=月 / 5=年 / 6=5分 / 7=15分 / 8=30分 / 9=60分 / 10=3分 / 11=季

請求示例

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

響應參數

參數	類型	說明
data.items	object[]
data.update_interval	integer	建議客戶端刷新間隔（秒）
data.items[].timestamp	integer	該根籌碼對應日期 0 點（Unix 秒）
data.items[].current_price	string	查詢時現價
data.items[].avg_cost	string	籌碼平均成本
data.items[].high_avg_cost	string	現價上方籌碼均價（套牢盤/壓力位）
data.items[].low_avg_cost	string	現價下方籌碼均價（獲利盤/支撐位）
data.items[].profit_ratio	string	獲利比例百分數（如 35.2 表示 35.2%）
data.items[].interpretation	string	獲利解讀說明
data.items[].seventy_begin	string	70% 籌碼區間起始價
data.items[].seventy_end	string	70% 籌碼區間結束價
data.items[].ninety_begin	string	90% 籌碼區間起始價
data.items[].ninety_end	string	90% 籌碼區間結束價
data.items[].interval_overlap	string	籌碼區間重合度百分數
data.items[].price_precision	string	返回價格精度
data.items[].histogram	object	價格-持倉量直方圖，按價位排列
data.items[].histogram[].price	string	價位
data.items[].histogram[].volume	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": {
    "update_interval": "example",
    "items": [
      {
        "timestamp": 0,
        "current_price": "example",
        "avg_cost": "example",
        "high_avg_cost": "example",
        "low_avg_cost": "example",
        "profit_ratio": "example"
      }
    ]
  }
}