分页约定
行情接口存在多种分页契约,不能统一替换参数名。请以每个接口的请求字段及响应顶层 pagination 为准;分页信息不在 data 内。
| 类型 | 请求 | 继续翻页 | 停止条件 |
|---|---|---|---|
| 存量游标接口,例如板块成分股、筛选 | next_key + limit | 原样回传 pagination.next_key | pagination.has_more=false |
| 列表接口,例如 ARK、产业链、可组合事件 | page_flag + page_size | 原样回传 pagination.page_flag | pagination.completed=true |
| 历史 K 线 | 首次 end 或 next_time;续页优先 page_token | 回传 pagination.next_page_token;没有令牌时回传 data.next_time | pagination.has_more=false |
| 按日期区间查询,例如历史资金流向 | 接口指定的日期范围 | 按接口约定调整日期范围 | 以该接口返回的停止信号为准 |
首页游标一般省略或传空字符串;每页数量的默认值和上限因接口而异。游标应视为不透明字符串,不要自行构造,也不要仅凭一页条数不足或为空就判断结束。总数仅在部分接口中返回。
历史 K 线令牌有效期 15 分钟,绑定当前用户和有效查询参数;续页时保持标的、start、ktype、autype、num、extended_time、pred_side 不变。有效令牌只豁免被标记为历史首请求的限频规则。详情见历史 K 线。
仓库对新设计列表接口另有统一命名规范;以上说明的是当前服务已实现的契约,不能据此将存量请求重命名为其他分页参数。