破淨高股息國央企近似榜

GET /api/v1.0/quote/rank/high-dividend-soe

破淨高股息國央企近似榜（對齊 OpenD Qot_GetHighDividendSOERank）：港股、PB<=1、股息率 TTM>=5%、PE>=0，按指定字段排序（默認市值）。 返回現價、漲跌、市值、PE/PB、股息率及多週期漲跌幅。測試環境可能無命中。count 默認 10、最大 300。

請求參數

參數	類型	位置	必填	說明
sort_field	string	查詢	否	排序字段，默認 MARKET_CAP
sort_dir	string	查詢	否	排序方向，默認 DESCENDING
page_flag	string	查詢	否	翻頁標記。首頁不傳或傳空串；下一頁回傳上一頁響應 pagination.page_flag。只有 pagination.completed 為 true 時停止
page_size	int	查詢	否	返回條數，默認 10，最大 300

請求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/rank/high-dividend-soe' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

參數	類型	說明
data.items	object[]
data.items[].code	string	標的代碼
data.items[].name	string	標的名稱
data.items[].industry	string	所屬行業（選股器不回傳，佔位為空串）
data.items[].cur_price	string	最新價
data.items[].change_ratio	string	漲跌幅（百分數）
data.items[].market_cap	number	市值
data.items[].pe_ttm	number	市盈率 TTM
data.items[].pb	number	市淨率
data.items[].dividend_yield_ttm	number	股息率 TTM（百分數）
data.items[].change_rate_5d	number	5 日漲跌幅（百分數）
data.items[].change_rate_10d	number	10 日漲跌幅（百分數）
data.items[].change_rate_20d	number	20 日漲跌幅（百分數）
data.items[].change_rate_60d	number	60 日漲跌幅（百分數）
data.items[].change_rate_120d	number	120 日漲跌幅（百分數）
data.items[].change_rate_250d	number	250 日漲跌幅（百分數）
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": [
      {
        "code": "US.AAPL",
        "name": "example",
        "industry": "example",
        "cur_price": "example",
        "change_ratio": "example",
        "market_cap": 1.2,
        "pe_ttm": 1.2,
        "pb": 1.2,
        "dividend_yield_ttm": 1.2,
        "change_rate_5d": 1.2,
        "change_rate_10d": 1.2,
        "change_rate_20d": 1.2,
        "change_rate_60d": 1.2,
        "change_rate_120d": 1.2,
        "change_rate_250d": 1.2
      }
    ]
  },
  "pagination": {
    "page_flag": "",
    "completed": true,
    "total": 0
  }
}