debank

Script Usage

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

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.

DeBank

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

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().

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.

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.

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).

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.

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).

When to Use 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

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

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

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

Check DeFi Protocol Positions

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

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

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

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

Chain Information

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

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)

Chain ID Reference

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.

Address Format

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

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