Cryptoclaw debank

Query DeBank OpenAPI for wallet portfolios, token holdings, DeFi positions, and transaction history.

install
source · Clone the upstream repo
git clone https://github.com/TermiX-official/cryptoclaw
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/TermiX-official/cryptoclaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/debank" ~/.claude/skills/termix-official-cryptoclaw-debank && rm -rf "$T"
manifest: skills/debank/SKILL.md
source content

DeBank OpenAPI

Query wallet portfolios, token balances, DeFi protocol positions, NFTs, and transaction history across 100+ EVM chains.

Base URL

https://pro-openapi.debank.com/v1

Requires API key: set

DEBANK_API_KEY
. Paid plans at https://cloud.debank.com/open-api

Pass via header:

AccessKey: {key}

Endpoints

Total Balance

GET /user/total_balance?id={address}

Returns total USD value across all chains.

Chain Balances

GET /user/chain_list?id={address}

Returns per-chain balance breakdown with chain name, logo, and USD value.

Token List

GET /user/all_token_list?id={address}&is_all=true

Returns all token holdings across all chains with:

  • chain
    — chain identifier
  • name
    ,
    symbol
    ,
    decimals
  • amount
    — raw balance
  • price
    — current USD price
  • logo_url

Filter by chain:

GET /user/token_list?id={address}&chain_id={chain}

Chain IDs:

bsc
,
eth
,
matic
,
arb
,
op
,
base
,
avax
,
ftm

DeFi Protocol Positions

GET /user/all_complex_protocol_list?id={address}

Returns all DeFi positions grouped by protocol:

  • Lending (supply/borrow)
  • Liquidity pools (LP positions)
  • Farming (staked tokens + rewards)
  • Vesting / locked tokens

Each position includes USD value, APY (when available), and health factor for lending.

Filter by chain:

GET /user/complex_protocol_list?id={address}&chain_id={chain}

NFT List

GET /user/all_nft_list?id={address}&is_all=true

Returns NFT holdings with collection name, floor price, and image.

Transaction History

GET /user/history_list?id={address}&chain_id={chain}&page_count=20

Returns parsed transaction history with human-readable descriptions:

  • Swap, Send, Receive, Approve, Contract Interaction
  • Token amounts and counterparties
  • Pagination via
    start_time
    parameter

Token Info

GET /token?id={address}&chain_id={chain}

Returns token metadata: name, symbol, price, market cap, holders, logo.

Protocol Info

GET /protocol?id={protocol_id}

Returns protocol details: TVL, chains, site URL, logo.

Protocol List

GET /protocol/list

Returns all tracked protocols. Large payload — filter output.

Usage Notes

  • DeBank tracks 100+ EVM chains automatically — no need to query each chain separately when using
    all_*
    endpoints
  • Always use
    all_token_list
    and
    all_complex_protocol_list
    for full portfolio overview
  • For transaction history,
    chain_id
    is required — ask user which chain or iterate through their active chains
  • DeFi positions include detailed breakdowns (supply vs borrow, LP composition) — present clearly
  • Combine with
    coingecko
    for price charts and
    security-check
    for token risk assessment
  • Rate limits depend on plan tier — avoid unnecessary repeated calls

Example Interactions

User: "What's in my wallet?" → Call

all_token_list
for active wallet, present holdings sorted by USD value

User: "Show my DeFi positions" → Call

all_complex_protocol_list
, group by protocol, show value and APY

User: "What's the portfolio of 0x...?" → Call

total_balance
for overview, then
all_token_list
for details

User: "Show my recent transactions on BSC" → Call

history_list
with
chain_id=bsc
, present last 20 parsed transactions