debank

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Script Usage

脚本使用方法

Script-mode skill — read this file, then invoke from a

bash

block:

bash

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/debank")
from exports import db_chain_list, db_user_total_balance, db_user_all_token_list

print(db_chain_list()[:3])
print(db_user_total_balance(user_addr="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"))
EOF

Read

exports.py

for the full list of

db_*

functions and exact signatures. Common ones:

db_chain_list

db_chain

db_token

db_user_total_balance

db_user_all_token_list

db_user_all_simple_protocol_list

db_user_all_complex_protocol_list

db_user_history_list

db_protocol

db_pre_exec_tx

db_explain_tx

脚本模式技能——阅读本文件后，在

bash

代码块中调用：

bash

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/debank")
from exports import db_chain_list, db_user_total_balance, db_user_all_token_list

print(db_chain_list()[:3])
print(db_user_total_balance(user_addr="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"))
EOF

查看

exports.py

获取完整的

db_*

函数列表及精确签名。常用函数包括：

db_chain_list

、

db_chain

、

db_token

、

db_user_total_balance

、

db_user_all_token_list

、

db_user_all_simple_protocol_list

、

db_user_all_complex_protocol_list

、

db_user_history_list

、

db_protocol

、

db_pre_exec_tx

、

db_explain_tx

。

DeBank

DeBank provides comprehensive blockchain data including wallet portfolios, token balances, transaction history, DeFi protocol positions, NFTs, and transaction simulation.

DeBank提供全面的区块链数据服务，涵盖钱包资产组合、代币余额、交易历史、DeFi协议持仓、NFT以及交易模拟功能。

Function Reference (signatures)

函数参考（签名）

All functions are in

exports.py

chain_id

uses DeBank's lowercase codes:

eth

bsc

arb

op

base

matic

avax

sol

era

scrl

linea

mnt

blast

, etc. — use

db_chain_list()

to enumerate.

user_addr

is the wallet address (lowercase).

protocol_id

from

db_protocol_list()

所有函数都在

exports.py

中。

chain_id

使用DeBank的小写编码：

eth

、

bsc

、

arb

、

op

、

base

、

matic

、

avax

、

sol

、

era

、

scrl

、

linea

、

mnt

、

blast

等——可调用

db_chain_list()

获取完整列表。

user_addr

为钱包地址（小写）。

protocol_id

可从

db_protocol_list()

获取。

Chain & Token reference

链与代币参考

Function	Description
`db_chain_list()`	List all supported chains.
`db_chain(chain_id)`	One chain's metadata.
`db_gas_market(chain_id)`	Gas prices for a chain.
`db_token(chain_id, token_id)`	Token detail. `token_id` = contract address (or `eth` , `bnb` for native).
`db_token_list_by_ids(chain_id, token_ids)`	Batch token lookup.
`db_token_history_price(chain_id, token_id, start_time, end_time=None)`	Historical prices (unix timestamps).
`db_token_top_holders(chain_id, token_id, start=0)`	Top holders.

函数	描述
`db_chain_list()`	列出所有支持的链。
`db_chain(chain_id)`	获取单条链的元数据。
`db_gas_market(chain_id)`	获取某条链的Gas价格。
`db_token(chain_id, token_id)`	获取代币详情。 `token_id` 为合约地址（原生代币可用 `eth` 、 `bnb` ）。
`db_token_list_by_ids(chain_id, token_ids)`	批量查询代币信息。
`db_token_history_price(chain_id, token_id, start_time, end_time=None)`	获取代币历史价格（时间戳格式）。
`db_token_top_holders(chain_id, token_id, start=0)`	获取代币持仓大户。

User portfolio (single-chain)

用户资产组合（单链）

Function	Description
`db_user_chain_balance(user_addr, chain_id)`	USD value on one chain.
`db_user_token_list(user_addr, chain_id, is_all=None)`	Tokens on one chain.
`db_user_token(user_addr, chain_id, token_id)`	One token balance.
`db_user_simple_protocol_list(user_addr, chain_id)`	DeFi positions (light) on one chain.
`db_user_complex_protocol_list(user_addr, chain_id)`	DeFi positions (detailed) on one chain.
`db_user_nft_list(user_addr, chain_id, is_all=None)`	NFTs on one chain.
`db_user_history_list(user_addr, chain_id, start_time=None, page_count=None)`	Tx history on one chain.
`db_user_chain_net_curve(user_addr, chain_id)`	Net worth curve on one chain.
`db_user_token_authorized_list(user_addr, chain_id)`	Token approvals (security audit).
`db_user_nft_authorized_list(user_addr, chain_id)`	NFT approvals.

函数	描述
`db_user_chain_balance(user_addr, chain_id)`	获取用户在某条链上的资产USD估值。
`db_user_token_list(user_addr, chain_id, is_all=None)`	获取用户在某条链上的代币列表。
`db_user_token(user_addr, chain_id, token_id)`	获取用户某条链上的单个代币余额。
`db_user_simple_protocol_list(user_addr, chain_id)`	获取用户在某条链上的DeFi轻量持仓信息。
`db_user_complex_protocol_list(user_addr, chain_id)`	获取用户在某条链上的DeFi详细持仓信息。
`db_user_nft_list(user_addr, chain_id, is_all=None)`	获取用户在某条链上的NFT列表。
`db_user_history_list(user_addr, chain_id, start_time=None, page_count=None)`	获取用户在某条链上的交易历史。
`db_user_chain_net_curve(user_addr, chain_id)`	获取用户在某条链上的净值曲线。
`db_user_token_authorized_list(user_addr, chain_id)`	获取用户在某条链上的代币授权情况（安全审计）。
`db_user_nft_authorized_list(user_addr, chain_id)`	获取用户在某条链上的NFT授权情况。

User portfolio (all-chain — heavier calls)

用户资产组合（全链——调用成本较高）

Function	Description
`db_user_total_balance(user_addr)`	Total USD across all chains + breakdown.
`db_user_total_net_curve(user_addr)`	Net worth curve across all chains.
`db_user_used_chain_list(user_addr)`	Which chains the address has used.
`db_user_all_token_list(user_addr, is_all=None)`	All tokens across all chains.
`db_user_all_simple_protocol_list(user_addr)`	All DeFi positions (light).
`db_user_all_complex_protocol_list(user_addr)`	All DeFi positions (detailed).
`db_user_all_nft_list(user_addr, is_all=None)`	All NFTs.
`db_user_all_history_list(user_addr, start_time=None, page_count=None)`	All tx history.
`db_user_complex_app_list(user_addr)`	All app-level positions (more granular).

函数	描述
`db_user_total_balance(user_addr)`	获取用户全链资产总USD估值及明细。
`db_user_total_net_curve(user_addr)`	获取用户全链资产净值曲线。
`db_user_used_chain_list(user_addr)`	获取用户已使用的链列表。
`db_user_all_token_list(user_addr, is_all=None)`	获取用户全链代币列表。
`db_user_all_simple_protocol_list(user_addr)`	获取用户全链DeFi轻量持仓信息。
`db_user_all_complex_protocol_list(user_addr)`	获取用户全链DeFi详细持仓信息。
`db_user_all_nft_list(user_addr, is_all=None)`	获取用户全链NFT列表。
`db_user_all_history_list(user_addr, start_time=None, page_count=None)`	获取用户全链交易历史。
`db_user_complex_app_list(user_addr)`	获取用户全链应用级持仓信息（更细粒度）。

Protocol reference

协议参考

Function	Description
`db_protocol(protocol_id)`	Protocol detail.
`db_protocol_list(chain_id)`	Protocols on one chain.
`db_protocol_all_list()`	All protocols across chains.
`db_app_protocol_list()`	App-level protocols (groups).
`db_user_protocol(user_addr, protocol_id)`	User's position in one protocol.
`db_pool(protocol_id, chain_id, pool_id)`	One pool's detail.

函数	描述
`db_protocol(protocol_id)`	获取协议详情。
`db_protocol_list(chain_id)`	获取某条链上的协议列表。
`db_protocol_all_list()`	获取全链协议列表。
`db_app_protocol_list()`	获取应用级协议分组列表。
`db_user_protocol(user_addr, protocol_id)`	获取用户在某一协议中的持仓情况。
`db_pool(protocol_id, chain_id, pool_id)`	获取某一资金池的详情。

Tx simulation

交易模拟

Function	Description
`db_pre_exec_tx(user_addr, chain_id, tx)`	Simulate tx before sending. `tx` = standard tx dict.
`db_explain_tx(user_addr, chain_id, tx)`	Human-readable explanation of a tx.

DeBank uses snake_case (

total_usd_value

chain_id

usd_value

). USD values are floats. Token amounts are floats (already adjusted for decimals — no need to divide by

10**decimals

函数	描述
`db_pre_exec_tx(user_addr, chain_id, tx)`	发送前模拟交易。 `tx` 为标准交易字典。
`db_explain_tx(user_addr, chain_id, tx)`	生成交易的人类可读解析说明。

DeBank使用蛇形命名法（

total_usd_value

、

chain_id

、

usd_value

）。USD值为浮点数，代币数量为已调整小数位的浮点数（无需再除以

10**decimals

）。

When to Use DeBank

DeBank适用场景

Use DeBank for:

User Portfolio - Total balance, token holdings, NFTs across all chains
Transaction History - Historical transactions on single or all chains
DeFi Positions - Protocol balances and complex portfolio positions
Token Data - Token details, prices, and top holders
Transaction Simulation - Pre-execute and explain transactions before submission
Authorization Tracking - View token and NFT approvals
Analytics - 24-hour net worth curves and portfolio tracking

DeBank适用于以下场景：

用户资产组合 - 全链总余额、代币持仓、NFT管理
交易历史 - 单链或全链的历史交易记录查询
DeFi持仓 - 协议余额及复杂资产组合持仓管理
代币数据 - 代币详情、价格及持仓大户查询
交易模拟 - 提交前预执行并解析交易
授权追踪 - 查看代币及NFT授权情况
数据分析 - 24小时净值曲线及资产组合追踪

Common Workflows

常见工作流程

Get User Portfolio

获取用户资产组合

db_user_total_balance(user_addr="0x...")  # Total balance across all chains
db_user_all_token_list(user_addr="0x...")  # All token holdings
db_user_all_nft_list(user_addr="0x...")  # All NFT collections

db_user_total_balance(user_addr="0x...")  # 全链总余额
db_user_all_token_list(user_addr="0x...")  # 所有代币持仓
db_user_all_nft_list(user_addr="0x...")  # 所有NFT藏品

Check Token Balances on Specific Chain

查询特定链上的代币余额

db_user_token_list(user_addr="0x...", chain_id="eth")  # Ethereum tokens
db_user_token_list(user_addr="0x...", chain_id="bsc")  # BSC tokens

db_user_token_list(user_addr="0x...", chain_id="eth")  # 以太坊代币
db_user_token_list(user_addr="0x...", chain_id="bsc")  # BSC代币

Get Transaction History

获取交易历史

db_user_history_list(user_addr="0x...", chain_id="eth")  # Eth transactions
db_user_all_history_list(user_addr="0x...")  # All chain transactions

db_user_history_list(user_addr="0x...", chain_id="eth")  # 以太坊交易记录
db_user_all_history_list(user_addr="0x...")  # 全链交易记录

Check DeFi Protocol Positions

查询DeFi协议持仓

db_user_simple_protocol_list(user_addr="0x...", chain_id="eth")  # Simple balances
db_user_complex_protocol_list(user_addr="0x...", chain_id="eth")  # Detailed positions
db_user_all_complex_protocol_list(user_addr="0x...")  # All chains

db_user_simple_protocol_list(user_addr="0x...", chain_id="eth")  # 轻量持仓余额
db_user_complex_protocol_list(user_addr="0x...", chain_id="eth")  # 详细持仓信息
db_user_all_complex_protocol_list(user_addr="0x...")  # 全链详细持仓

Token Information

代币信息查询

db_token(chain_id="eth", token_id="0x...")  # Token details
db_token_history_price(chain_id="eth", token_id="0x...", start_time=1234567890, end_time=1234567990)
db_token_top_holders(chain_id="eth", token_id="0x...")  # Top 100 holders

db_token(chain_id="eth", token_id="0x...")  # 代币详情
db_token_history_price(chain_id="eth", token_id="0x...", start_time=1234567890, end_time=1234567990)  # 代币历史价格
db_token_top_holders(chain_id="eth", token_id="0x...")  # 前100持仓大户

Transaction Simulation

交易模拟

db_pre_exec_tx(user_addr="0x...", chain_id="eth", tx={...})  # Enhanced pre-execution
db_explain_tx(user_addr="0x...", chain_id="eth", tx={...})  # Explain transaction

db_pre_exec_tx(user_addr="0x...", chain_id="eth", tx={...})  # 增强版预执行
db_explain_tx(user_addr="0x...", chain_id="eth", tx={...})  # 解析交易内容

Protocol Data

协议数据查询

db_protocol(protocol_id="uniswap")  # Protocol details
db_protocol_list(chain_id="eth")  # All protocols on chain
db_protocol_all_list()  # All protocols across chains

db_protocol(protocol_id="uniswap")  # 协议详情
db_protocol_list(chain_id="eth")  # 链上所有协议
db_protocol_all_list()  # 全链所有协议

Chain Information

链信息查询

db_chain_list()  # All supported chains
db_chain(chain_id="eth")  # Specific chain details
db_gas_market(chain_id="eth")  # Gas prices

db_chain_list()  # 所有支持的链
db_chain(chain_id="eth")  # 指定链的详情
db_gas_market(chain_id="eth")  # Gas价格

Important Notes

重要说明

API Key: Requires DEBANK_API_KEY environment variable (DeBank Cloud API)
User Address: Most endpoints require a valid blockchain address (0x... format)
Chain IDs: Use DeBank chain identifiers (eth, bsc, polygon, arbitrum, optimism, etc.)
Rate Limits: Be mindful of API rate limits and unit costs
Unit Costs: Different endpoints have different unit costs (see API documentation)

API密钥：需要设置DEBANK_API_KEY环境变量（DeBank云API）
用户地址：大多数接口需要有效的区块链地址（0x...格式）
链ID：使用DeBank的链标识符（eth、bsc、polygon、arbitrum、optimism等）
速率限制：注意API速率限制及单位成本
单位成本：不同接口的单位成本不同（详见API文档）

Chain ID Reference

链ID参考

Common chain identifiers:

eth → Ethereum Mainnet
bsc → BNB Smart Chain
polygon → Polygon
arbitrum → Arbitrum One
optimism → Optimism
avax → Avalanche C-Chain
ftm → Fantom
op → Optimism
base → Base

Important: Use

db_chain_list()

to get the complete list of supported chains and their identifiers.

常用链标识符：

eth → 以太坊主网
bsc → BNB智能链
polygon → Polygon链
arbitrum → Arbitrum One
optimism → Optimism
avax → Avalanche C链
ftm → Fantom
op → Optimism
base → Base链

重要提示：调用

db_chain_list()

获取支持的完整链列表及标识符。

Address Format

地址格式

All user addresses should be in Ethereum format (0x followed by 40 hexadecimal characters):

Valid: 0x1234567890abcdef1234567890abcdef12345678
Invalid: 1234567890abcdef1234567890abcdef12345678 (missing 0x prefix)

所有用户地址需采用以太坊格式（0x开头，后跟40个十六进制字符）：

有效格式：0x1234567890abcdef1234567890abcdef12345678
无效格式：1234567890abcdef1234567890abcdef12345678（缺少0x前缀）