debank.com APIdebank.com ↗
Access DeBank wallet portfolios via API. Retrieve DeFi protocol positions, idle token balances, asset exposure buckets, and wallet profile data for any address.
curl -X GET 'https://api.parse.bot/scraper/b9d9f61a-6336-4f05-850e-3189194dbada/get_full_portfolio_json' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the full portfolio JSON for a wallet address, including wallet profile, DeFi protocol positions, asset exposure buckets, and idle token balances.
| Param | Type | Description |
|---|---|---|
| addressrequired | string | Wallet address to retrieve portfolio data for. |
| min_position_usd | number | Exclude positions below this USD value |
{
"type": "object",
"fields": {
"protocols": "array",
"idle_wallet": "object",
"wallet_overview": "object",
"exposure_buckets": "object"
},
"sample": {
"wallet_overview": {
"address": "0xd8...",
"num_chains": 70,
"num_protocols": 20,
"total_net_value_usd": 1990862
}
}
}About the debank.com API
The DeBank API exposes 2 endpoints covering wallet-level DeFi portfolio data from debank.com. The get_full_portfolio_json endpoint returns protocol-level positions, idle token balances, asset exposure buckets, and a wallet overview in a single call. A companion get_wallet_profile endpoint provides summary figures — including total USD value and follower count — for any Ethereum-compatible wallet address.
Portfolio Data
The get_full_portfolio_json endpoint accepts a required address parameter and an optional min_position_usd filter to exclude small positions from the response. It returns four top-level objects: protocols (an array of DeFi protocol positions), idle_wallet (tokens sitting in the wallet not deployed to any protocol), wallet_overview (aggregate balances and net worth), and exposure_buckets (categorical breakdown of asset exposure, such as stablecoins, native assets, or yield-bearing positions).
Wallet Profile
The get_wallet_profile endpoint retrieves lightweight identity and summary data for a given address. The response includes the wallet id, total usd_value, and follower_count — the last field reflecting DeBank's social layer, where addresses can be followed by other users on the platform.
Filtering and Scope
The min_position_usd parameter on get_full_portfolio_json is the primary way to reduce noise from dust positions. The filter applies across protocol positions, letting you focus on material holdings. Both endpoints key off a single address string, so multi-wallet aggregation requires multiple calls. There is no batch-address parameter in the current specification.
- Track a wallet's total DeFi net worth over time using
usd_valuefromget_wallet_profile - Build a protocol-exposure dashboard by parsing the
protocolsarray fromget_full_portfolio_json - Identify idle (undeployed) tokens in a wallet using the
idle_walletresponse field - Filter out dust positions in automated portfolio reports with the
min_position_usdparameter - Analyze asset category exposure (stablecoin vs. native vs. yield) via the
exposure_bucketsfield - Monitor whale wallets by combining
usd_valueandfollower_countfromget_wallet_profile
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DeBank have an official developer API?+
What does the `exposure_buckets` field contain in `get_full_portfolio_json`?+
exposure_buckets object breaks down a wallet's holdings into asset categories — for example, stablecoins, native chain assets, and yield-bearing or LP positions. It gives a percentage or value distribution across those buckets rather than listing individual tokens.Can I retrieve historical portfolio snapshots or transaction history through this API?+
Does the API support querying multiple wallet addresses in a single request?+
address parameter per call. Batch queries are not supported in the current specification. You can fork this API on Parse and revise it to loop over multiple addresses or add a batch endpoint.What does `follower_count` in `get_wallet_profile` represent?+
follower_count field reflects how many DeBank users follow the queried address. It is a DeBank-specific metric and does not represent on-chain activity.