Stock Cost Distribution

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

Chip distribution histogram plus profit ratio / cost zones. Defaults to 1 daily bar for the query date (today if omitted); count walks backward. Prices unscaled; profit_ratio is percent. Primarily A-shares; items is empty when no data.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Symbol (path param), e.g. SH.600519 / SZ.000001
date	string	query	no	Query date yyyy-MM-dd (aligned to 00:00); omit for now
count	int	query	no	How many periods to walk back from date, default 1, max 20
ktype	int	query	no	K-line period: 1=1-min / 2=day (default) / 3=week / 4=month / 5=year / 6=5-min / 7=15-min / 8=30-min / 9=60-min / 10=3-min / 11=quarter

Example

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

Response

Field	Type	Description
data.items	object[]
data.update_interval	integer	Suggested client refresh interval in seconds
data.items[].timestamp	integer	Bar date aligned to 00:00, unix seconds
data.items[].current_price	string	Spot price at query time
data.items[].avg_cost	string	Average chip cost
data.items[].high_avg_cost	string	Average cost of chips above spot (resistance)
data.items[].low_avg_cost	string	Average cost of chips below spot (support)
data.items[].profit_ratio	string	Profit ratio percent (e.g. 35.2 means 35.2%)
data.items[].interpretation	string	Profit-ratio interpretation text
data.items[].seventy_begin	string	70% chip-range start price
data.items[].seventy_end	string	70% chip-range end price
data.items[].ninety_begin	string	90% chip-range start price
data.items[].ninety_end	string	90% chip-range end price
data.items[].interval_overlap	string	Chip-range overlap percent
data.items[].price_precision	string	Price precision of the histogram
data.items[].histogram	object	Price-volume histogram
data.items[].histogram[].price	string	Price level
data.items[].histogram[].volume	integer	Chip volume at this price (shares)

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": {
    "update_interval": "example",
    "items": [
      {
        "timestamp": 0,
        "current_price": "example",
        "avg_cost": "example",
        "high_avg_cost": "example",
        "low_avg_cost": "example",
        "profit_ratio": "example"
      }
    ]
  }
}