DeBank历史记录:核时间游标、分类与授权事件
链小知 · 进阶 · 核验 · 依官方文档整理
按API Pro官方响应核已有历史材料,避免把20条分页、授权事件和余额变化混成全量记录。
开始前准备
- 准备既有脱敏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范围可复原。
2. 按时间游标保留分页缺口
start_time表示返回早于该时间的历史;未提供时返回最近记录。page_count最大20,单链说明默认20。少于20条或空页本身不能证明目标日期范围、所有支持链或所有历史都完整。
核既有每页start_time与history_list.time_at,按chain和id保留原记录并标识重复。文档没有给同一时间戳并列条目的稳定分页保证,不自行承诺按最小时间继续翻页绝不会漏条;若某页边界同秒多条,单列待核。
检查结果:页大小、时间边界及重复/同时间边界未知均有记录。
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合并。
检查结果:分类、流入流出、授权对象和资产身份分开,当前权限保持待核。
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日期比较功能,本教程不声称已验证其按钮或历史资产估值。
检查结果:基础交易、费用、原响应和文档路径歧义分别保留。
怎样确认完成
- 留下输入范围、原材料、核对结果和未知项;没有实例或回执时保持未验证。
常见错误与边界
- 交易历史、当前仓位、当前授权额度、VIP Time Machine各是不同任务。