分页约定

所有涉及列表分页的接口遵循统一约定。

入参

参数	类型	说明
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 分钟发出第一个请求。