查询参数

分页

分页参数写法说明。

查询类接口通常支持分页参数。以 daily 为代表的列表接口,分页主要通过 limitoffset 控制。

分页参数

列表型接口通常支持:

  • limit:每页条数
  • offset:偏移量

重点说明

  • 所有接口单次最多返回 6000
  • daily 默认 limit = 100
  • daily 默认 offset = 0

示例

第一页

{
  "apiname": "daily",
  "params": {
    "limit": 100,
    "offset": 0
  }
}

下一页

{
  "apiname": "daily",
  "params": {
    "limit": 100,
    "offset": 100
  }
}

返回字段

分页结果通常会在 data 中返回:

  • total:总记录数
  • limit:本次请求的分页大小
  • offset:本次请求的偏移量

例如:

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": ["symbol", "name", "tradedate", "close"],
    "items": [],
    "total": 2450,
    "limit": 100,
    "offset": 0
  }
}

使用提示

  • 如果需要拉取更多数据,请通过多次请求配合 offset 分页获取
  • limit 不能超过 6000