AgentSkillsCN

debank

调用DeBank OpenAPI，查询钱包组合、代币持仓、DeFi头寸以及交易历史。

SKILL.md
--- frontmatter
name: debank
description: Query DeBank OpenAPI for wallet portfolios, token holdings, DeFi positions, and transaction history.
metadata:
  {
    "cryptoclaw":
      { "emoji": "🏦", "requires": { "env": ["DEBANK_API_KEY"] }, "primaryEnv": "DEBANK_API_KEY" },
  }

DeBank OpenAPI

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

Base URL

code
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

code
GET /user/total_balance?id={address}

Returns total USD value across all chains.

Chain Balances

code
GET /user/chain_list?id={address}

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

Token List

code
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

code
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

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

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

Transaction History

code
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

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

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

Protocol Info

code
GET /protocol?id={protocol_id}

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

Protocol List

code
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