分頁約定

所有涉及列表分頁的接口遵循統一約定。

入參

參數	類型	說明
next_key	string	翻頁遊標，首頁留空 ""。把上一頁響應的 pagination.next_key 原樣回傳即可取下一頁。
limit	int	每頁條數（各接口有各自默認值與上限）。

出參

分頁信息統一放在響應頂層的 pagination 對象（不在 data 內）：

字段	類型	說明
has_more	bool	是否還有下一頁。以 has_more=false 作為停止翻頁的唯一信號。
next_key	string	下一頁遊標；無更多頁時為 "-1"。
total	int（可選）	滿足條件的總條數，僅部分接口返回（如篩選、評級彙總、內部人列表、估值列表、板塊成分股等）。

TIP

遊標 next_key 對調用方不透明，請勿自行解析或構造。

示例

請求第一頁：

curl -s -X POST "https://webapi.moomoo.com/api/v1.0/quote/plate/HK.BK1001/stock" \
  -H "Content-Type: application/json" \
  -H "X-Futu-Client-Nnid: 76879657" \
  -d '{"next_key":"","limit":20}' | jq

響應：

{
  "code": 0,
  "data": { ... },
  "pagination": {
    "has_more": true,
    "next_key": "eyJsYXN0X2lkIjo0MH0=",
    "total": 156
  }
}

請求下一頁：

curl -s -X POST "https://webapi.moomoo.com/api/v1.0/quote/plate/HK.BK1001/stock" \
  -H "Content-Type: application/json" \
  -H "X-Futu-Client-Nnid: 76879657" \
  -d '{"next_key":"eyJsYXN0X2lkIjo0MH0=","limit":20}' | jq

例外

少數按日期區間拉取的接口（get_capital_flow_history、request_history_kline）以 pagination.has_more 指示是否還有更早數據，通過調整日期區間向更早翻頁（capital 用 end、history-kline 用 extra.next_time 作為下一頁 end），不使用 next_key 遊標。

參考

• 行情 API 概覽 — 行情接口總覽。
• 快速開始 — 5 分鐘發出第一個請求。