个股筹码分布

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