多週期漲跌幅榜

GET /api/v1.0/quote/rank/period-change

多週期漲跌幅榜。按指定週期的漲跌幅排序，並同時返回 5 分鐘 / 5/10/20/60/120/250 日 / 年初至今漲跌幅，以及現價、成交額量、市值、PE/PB、換手、量比、振幅。 默認過濾價格 ≥ 1、市值 ≥ 1e7、區間漲跌幅絕對值 ≤ 100000%，對齊 OpenD PeriodChangeRank。 支持市場 HK/US/SH/SZ/SG/JP/AU/CA/MY；period_type 默認 5DAY。SH/SZ 均映射為 CN 市場。

請求參數

參數	類型	位置	必填	說明
market	string	查詢	是	市場代碼
period_type	string	查詢	否	排序週期，默認 5DAY
sort_dir	string	查詢	否	排序方向，默認 DESCENDING
page_flag	string	查詢	否	翻頁標記。首頁不傳或傳空串；下一頁回傳上一頁響應 pagination.page_flag。只有 pagination.completed 為 true 時停止
page_size	int	查詢	否	返回條數，默認 10，最大 200
price_filter	string	查詢	否	價格篩選
market_cap_min	number	查詢	否	最小市值（元），不傳則默認 1e7 對齊 OpenD
market_cap_max	number	查詢	否	最大市值（元），不傳不限制
pe_min	number	查詢	否	最小市盈率，不傳不限制
pe_max	number	查詢	否	最大市盈率，不傳不限制

請求示例

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

響應參數

參數	類型	說明
data.items	object[]
data.items[].code	string	標的代碼
data.items[].name	string	標的名稱
data.items[].cur_price	string	最新價
data.items[].change_ratio	string	當日漲跌幅（百分數），與 OpenD change_ratio 對齊；排序週期漲跌幅見 change_rate_* 字段
data.items[].turnover	string	成交額
data.items[].volume	string	成交量
data.items[].market_cap	number	市值
data.items[].change_rate_5min	number	5 分鐘漲跌幅（百分數）
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 日漲跌幅（百分數）
data.items[].change_rate_ytd	number	年初至今漲跌幅（百分數）
data.items[].pe_ttm	number	市盈率 TTM
data.items[].pb	number	市淨率
data.items[].turnover_ratio	string	換手率（百分數）
data.items[].volume_ratio	string	量比
data.items[].amplitude	number	振幅（百分數）
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",
        "cur_price": "example",
        "change_ratio": "example",
        "turnover": "example",
        "volume": "example",
        "market_cap": 1.2,
        "change_rate_5min": 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,
        "change_rate_ytd": 1.2,
        "pe_ttm": 1.2,
        "pb": 1.2,
        "turnover_ratio": "example",
        "volume_ratio": "example",
        "amplitude": 1.2
      }
    ]
  },
  "pagination": {
    "page_flag": "",
    "completed": true,
    "total": 0
  }
}