# DeBank 少了一笔持仓：按地址、链、代币过滤和协议仓位逐层核对

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

使用官方只读数据字段区分漏索引、过滤、价格缺失和净资产口径，适合需复核聚合资产的读者与开发者。

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

## 前置条件
- 准备 EVM 公开地址、链、代币合约或协议 ID，以及已知持仓证据。
- 基础地址核对不需私钥；深度流程使用 DeBank Pro API 的 AccessKey，套餐和额度另查，不公开 key。
- 本教程依据 API 文档，未登录或实际调用付费 API；不保证网页各版本都有同名筛选菜单。

## 1. 固定地址与链范围

先核对完整地址，再用 used_chain_list/chain_balance 与原始交易证据定位 chain_id。查询全链接口时检查 chain_ids 是否限制范围；同一个 EVM 地址在不同链的仓位应分开。

核对结果：已知持仓地址与查询 id、chain_id 一致。
依据：[DeBank 官方 User API 条件与字段](https://docs.cloud.debank.com/en/readme/api-pro-reference/user)
依据：[Etherscan 转账与交易字段](https://info.etherscan.com/understanding-an-ethereum-transaction/)

## 2. 复查代币过滤

针对遗漏 token 用 /v1/user/token 的 id、chain_id、token_id 精确查询；或核查 token_list 的 is_all，true 包含 protocol-derived 与非 core token。列表过滤导致未展示不能当余额为零。

核对结果：核对 amount/raw_amount 与 decimals，并保存筛选条件。
依据：[DeBank 官方 User API 条件与字段](https://docs.cloud.debank.com/en/readme/api-pro-reference/user)

## 3. 把余额与估值分开

API 文档说明 price=0 代表没有价格数据，不证明持仓为零。分别比较 amount 与 price；合约/链都相符但 USD 估值缺失时，记录为估值缺口而不是资产丢失。

核对结果：数量问题、价格问题能分别解释。
依据：[DeBank 官方 User API 条件与字段](https://docs.cloud.debank.com/en/readme/api-pro-reference/user)

## 4. 核对协议仓位与债务

协议持仓看 protocol/complex_protocol_list；检查 has_supported_portfolio、portfolio_item_list、update_at，以及 asset_usd_value、debt_usd_value、net_usd_value。存款、奖励和借款不是同一列表，净资产低于总资产也未必是漏仓。

核对结果：协议支持与更新时间明确，供给/奖励/债务口径分开。
依据：[DeBank 官方 User API 条件与字段](https://docs.cloud.debank.com/en/readme/api-pro-reference/user)
依据：[DeBank 官方 PortfolioItemObject 仓位模型](https://docs.cloud.debank.com/en/readme/api-models/portfolioitemobject)

## 5. 未支持或空结果时保留未知

has_supported_portfolio=false、接口失败、权限/限额错误和成功返回零是四种不同状态。用原协议或链上证据保留该仓位；不能用聚合器缺失数据证明仓位不存在。协议内单项接口与缓存列表更新也可能有差异。

核对结果：遗漏报告包含地址/链/协议、响应状态、过滤与时间，未知不填零。
依据：[DeBank 官方 User API 条件与字段](https://docs.cloud.debank.com/en/readme/api-pro-reference/user)
依据：[DeBank 官方 PortfolioItemObject 仓位模型](https://docs.cloud.debank.com/en/readme/api-models/portfolioitemobject)

## 常见错误
- 接口失败被记成零资产。
- price=0 被理解为 token 数量为零。
- 只看普通 token 余额，忽略锁仓或债务。
- 从 protocol 的 site_url 直接连接未知网站，未核对真实协议入口。

## 完成检查
- 定位地址、链、过滤、价格或协议支持的具体差异。
- 净资产与总资产、供给与债务已区分。
- 未支持和接口失败保持未知；未执行钱包操作。

## 相关知识

## 官方依据
- [DeBank 官方 User API 条件与字段](https://docs.cloud.debank.com/en/readme/api-pro-reference/user)
- [DeBank 官方 PortfolioItemObject 仓位模型](https://docs.cloud.debank.com/en/readme/api-models/portfolioitemobject)
- [Etherscan 转账与交易字段](https://info.etherscan.com/understanding-an-ethereum-transaction/)