返回结构

猫爪数据接口默认采用统一外层结构。以 daily 为代表的查询接口，data 内部通常会继续使用表格化结构返回数据。

标准结构

{
  "code": 200,
  "message": "success",
  "data": {}
}

字段说明

字段	类型	说明
code	number	业务状态码，200 表示请求成功
message	string	返回说明，成功时通常为 success
data	object | array | null	实际返回数据，不同接口结构不同

daily 接口示例

daily 这类行情接口的 data 一般不是直接返回单个对象，而是返回表头和数据行：

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": ["symbol", "name", "tradedate", "close", "prev_turnover_rate_f", "up_limit"],
    "items": [
      ["000001", "平安银行", "20260316", 12.2, 1.03, 13.42]
    ],
    "total": 1,
    "limit": 100,
    "offset": 0
  }
}

data 内部含义

字段	类型	说明
fields	string[]	返回列名列表，可以理解为表头
items	array[]	数据行列表；每一行都按 fields 的顺序取值
total	number	当前查询条件下的总记录数
limit	number	本次请求的分页大小
offset	number	本次请求的分页偏移量

如果你更习惯对象结构，可以把 fields 作为键，把 items 中每一行按位置配对后还原成字典对象。