# DeBank历史记录：核时间游标、分类与授权事件

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/debank-history-cursor-approval-record-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

按API Pro官方响应核已有历史材料，避免把20条分页、授权事件和余额变化混成全量记录。

## 使用工具
- [DeBank](https://lianxiaozhi.com/tools/debank) · [官方入口](https://debank.com/)

## 前置条件
- 准备既有脱敏history_list/all_history_list请求记录及JSON响应，包含地址、网络、筛选和获取时间。
- 这里只按官方文档整理字段，未申请AccessKey、调用业务API、登录VIP或连接钱包。

## 1. 区分单链与多链输入

单链方法GET /v1/user/history_list要求id与chain_id，可用token_id限定相关资产。多链GET /v1/user/all_history_list要求id，chain_ids可选；不得把传入多条链或不传chain_ids的请求称作某一单链。

响应字典与history_list分别保存；按记录的实际链范围核，不从当前仓位查询反推已有完整交易历史。

核对结果：方法、地址、chain_id/chain_ids与token_id范围可复原。
依据：[DeBank API Pro：history_list与all_history_list输入及响应](https://docs.cloud.debank.com/en/readme/api-pro-reference/user.md)

## 2. 按时间游标保留分页缺口

start_time表示返回早于该时间的历史；未提供时返回最近记录。page_count最大20，单链说明默认20。少于20条或空页本身不能证明目标日期范围、所有支持链或所有历史都完整。

核既有每页start_time与history_list.time_at，按chain和id保留原记录并标识重复。文档没有给同一时间戳并列条目的稳定分页保证，不自行承诺按最小时间继续翻页绝不会漏条；若某页边界同秒多条，单列待核。

核对结果：页大小、时间边界及重复/同时间边界未知均有记录。
依据：[DeBank API Pro：history_list与all_history_list输入及响应](https://docs.cloud.debank.com/en/readme/api-pro-reference/user.md)

## 3. 用分类决定读取的嵌套字段

cate_dict解释approve、receive、send等分类。文档说明sends对应send、receives对应receive，token_approve对应approve；示例实际sends/receives是数组，缺值不把其他分类字段强行解释成代币转移。

授权记录中token_approve列spender、token_id、value；这是历史授权事件材料，不能据它判断当前剩余allowance、已撤销或真实资金支出。以chain和token_id核资产，不按相同symbol合并。

核对结果：分类、流入流出、授权对象和资产身份分开，当前权限保持待核。
依据：[DeBank API Pro：history_list与all_history_list输入及响应](https://docs.cloud.debank.com/en/readme/api-pro-reference/user.md)

## 4. 对照基础交易和保留文档拼写差异

tx示例含from_addr、to_addr、name、params、status、eth_gas_fee和usd_gas_fee，time_at在历史条目。核已有值与哈希，费用数量和USD估值不相加；该页未明示status所有枚举时不自编映射。

多链返回说明写history_hist并链接histroy拼写，但本页方法路径是all_history_list。按实际请求路径和响应记录核对，不能把文档拼写视作另一个已验证端点。Time Machine是另一个VIP日期比较功能，本教程不声称已验证其按钮或历史资产估值。

核对结果：基础交易、费用、原响应和文档路径歧义分别保留。
依据：[DeBank API Pro：history_list与all_history_list输入及响应](https://docs.cloud.debank.com/en/readme/api-pro-reference/user.md)

## 常见错误
- 交易历史、当前仓位、当前授权额度、VIP Time Machine各是不同任务。

## 完成检查
- 留下输入范围、原材料、核对结果和未知项；没有实例或回执时保持未验证。

## 相关知识

## 官方依据
- [DeBank API Pro：history_list与all_history_list输入及响应](https://docs.cloud.debank.com/en/readme/api-pro-reference/user.md)