指定市場行業/概念/主題板塊熱力圖數據

GET /api/v1.0/quote/heatmap

獲取指定市場行業/概念/主題板塊熱力圖數據，按漲跌幅/市值/成交額/熱度排序。 返回板塊代碼與名稱、最新價、漲跌幅、成交額量、市值、平均市盈率、漲跌平家數、領漲股、板塊描述。 count 默認 30、最大 200（與 OpenD 一致）。漲跌分佈請用 quote.heatmap.rise_fall_distribution。

請求參數

參數	類型	位置	必填	說明
market	string	查詢	是	市場代碼。SH 與 SZ 共用 A 股板塊集合
plate_type	string	查詢	否	板塊類型，默認 INDUSTRY。THEME 對應特色板塊集合
sort_field	string	查詢	否	排序字段，默認 CHANGE_RATE（漲跌幅）
sort_dir	string	查詢	否	排序方向，默認 DESCENDING
page_flag	string	查詢	否	翻頁標記。首頁不傳或傳空串；下一頁回傳上一頁響應 pagination.page_flag。只有 pagination.completed 為 true 時停止
page_size	int	查詢	否	返回條數，默認 30，最大 200

請求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/heatmap?market=HK' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

參數	類型	說明
data.items	object[]
data.items[].plate	string	板塊代碼，例: HK.BK1001
data.items[].plate_name	string	板塊名稱
data.items[].cur_price	string	板塊最新價
data.items[].change_rate	number	漲跌幅（百分數）
data.items[].turnover	string	成交額
data.items[].volume	string	成交量
data.items[].market_val	number	市值
data.items[].pe_avg	number	平均市盈率
data.items[].rise_count	int	上漲家數
data.items[].fall_count	int	下跌家數
data.items[].equal_count	int	平盤家數
data.items[].leader_stock	int	領漲股代碼
data.items[].description	string	板塊描述
pagination.total	int
pagination.completed	bool	是否已到末頁。只有 true 時停止翻頁
pagination.page_flag	string	下一頁標記。completed 為 false 時回傳為下一次請求的 page_flag；末頁為空串

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數不合法
-8	unsupported	不支持
-10	no_data	沒有數據

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "plate": "example",
        "plate_name": "example",
        "cur_price": "example",
        "change_rate": 1.2,
        "turnover": "example",
        "volume": "example",
        "market_val": 1.2,
        "pe_avg": 1.2,
        "rise_count": 0,
        "fall_count": 0,
        "equal_count": 0,
        "leader_stock": 0,
        "description": "example"
      }
    ]
  },
  "pagination": {
    "page_flag": "",
    "completed": true,
    "total": 0
  }
}