starchild-ai-agent 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)