K 線形態選股

GET /api/v1.0/quote/kline-shape/stocks

按指定 K 線形態（shape_type）、K 線週期（日 K / 60 分 K）與市場篩選當前符合該形態的股票列表。 返回包含：股票代碼（code）、名稱、現價（price）、昨收價（pre_close）、入選時間戳與日期、入選時價格（selected_price）及總市值（total_market_cap）。

請求參數

參數	類型	位置	必填	說明
shape_type	int	查詢	是	形態類型 ID（1=W型底, 2=三重底, 3=頭肩底, 4=圓弧底, 5=喇叭底, 6=看漲旗形, 7=看漲對稱三角形, 8=看漲持續菱形, 9=看漲持續楔形, 10=看漲持續三角形; 1001~1010 為對應看跌形態）
market	string	查詢	否	市場過濾，默認 US
ktype	int	查詢	否	K 線週期：2=日 K（默認）/ 9=60 分 K
sort_field	string	查詢	否	排序字段，默認 SELECTED_TIME（按入選時間）
sort_dir	string	查詢	否	排序方向，默認 DESCENDING
page_size	int	查詢	否	每頁條數，默認 20，最大 100
page_flag	string	查詢	否	翻頁遊標，首頁不傳或傳空串；下一頁回傳 pagination.page_flag

請求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/kline-shape/stocks?shape_type=1&market=1&ktype=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

參數	類型	說明
data.items	object[]
data.items[].code	string	股票代碼
data.items[].name	string	股票名稱
data.items[].price	number	最新價
data.items[].pre_close	number	昨收價
data.items[].selected_time	integer	形態入選時間（毫秒時間戳）
data.items[].selected_price	number	入選時價格
data.items[].total_market_cap	string	總市值
pagination.total	string	符合該形態的股票總數
pagination.completed	string	是否已到末頁
pagination.page_flag	string	下一頁遊標

錯誤碼

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": {
    "items": [
      {
        "code": "example",
        "name": "example",
        "price": "example",
        "pre_close": "example",
        "selected_time": 0,
        "selected_price": "example"
      }
    ]
  },
  "pagination": {
    "total": 1,
    "completed": true,
    "page_flag": ""
  }
}