Get user info such as total balance, token list, and portfolio in each protocol
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/debank-user-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: DeBank Open User API
version: '1.0'
description: Build for DeFi Developers.
servers:
- url: /
security:
- accessKey: []
tags:
- name: User
description: Get user info such as total balance, token list, and portfolio in each protocol
paths:
/v1/user/all_complex_protocol_list:
get:
responses:
'200':
description: return the list of protocol with user's portfolio items
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserProtocol'
description: Get list of protocols with user portfolio details on all supported chains
operationId: get_user_all_complex_protocol_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/all_history_list:
get:
responses:
'200':
description: return history list
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserHistory'
description: Get user all history list
operationId: get_user_history_all_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: chain_id
in: query
description: ChainID
schema:
type: string
- name: token_id
in: query
description: TokenID
schema:
type: string
- name: coin_id
in: query
description: CoinID
schema:
type: string
- name: page_count
in: query
description: PageCount
schema:
type: integer
- name: start_time
in: query
description: StartTime
schema:
type: integer
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/all_nft_list:
get:
responses:
'200':
description: return list of nfts of all chains
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserNft'
description: Get user nft list on all supported chains
operationId: get_user_nft_all_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: is_all
in: query
description: If true, all tokens are returned
schema:
type: boolean
default: true
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/all_simple_protocol_list:
get:
responses:
'200':
description: return list of protocols with user assets
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserSimpleProtocol'
description: Stats the user's protocol assets on all supported chains
operationId: get_user_all_simple_protocol_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/all_token_list:
get:
responses:
'200':
description: return user token balance list of all chain
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserToken'
description: Get user token balance
operationId: get_user_token_all_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: is_all
in: query
description: If true, all tokens are returned, including protocol-derived tokens
schema:
type: boolean
default: true
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/chain_balance:
get:
responses:
'200':
description: return to the usd value of net assets
content:
application/json:
schema:
$ref: '#/components/schemas/UserUsdValue'
description: Get the net assets of a chain
operationId: get_user_chain_balance
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
tags:
- User
/v1/user/chain_net_curve:
get:
responses:
'200':
description: Get the chain net curve
content:
application/json:
schema:
$ref: '#/components/schemas/NetCurve'
description: Get the chain net curve
operationId: get_user_chain_net_curve
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
tags:
- User
/v1/user/complex_app_list:
get:
responses:
'200':
description: return the list of apps with user's portfolio items
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserApp'
description: Get list of apps with user portfolio details on all supported app chains
operationId: get_user_complex_app_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
tags:
- User
/v1/user/complex_protocol_list:
get:
responses:
'200':
description: return the list of protocol with user's portfolio items
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserProtocol'
description: Get list of protocols with user portfolio details on a chain
operationId: get_user_complex_protocol_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
tags:
- User
/v1/user/history_list:
get:
responses:
'200':
description: return history list
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserHistory'
description: Get user history list
operationId: get_user_history_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: chain_id
in: query
description: ChainID
schema:
type: string
- name: token_id
in: query
description: TokenID
schema:
type: string
- name: coin_id
in: query
description: CoinID
schema:
type: string
- name: page_count
in: query
description: PageCount
schema:
type: integer
- name: start_time
in: query
description: StartTime
schema:
type: integer
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/nft_authorized_list:
get:
responses:
'200':
description: return list of nft with risk exposure
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserNFTAuthorized'
operationId: get_user_nft_authorized_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
tags:
- User
/v1/user/nft_list:
get:
responses:
'200':
description: return list of nfts of a chain
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserNft'
description: Get user nft list
operationId: get_user_nft_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
- name: is_all
in: query
description: If true, all tokens are returned
schema:
type: boolean
default: true
tags:
- User
/v1/user/protocol:
get:
responses:
'400':
description: Protocol not found
'200':
description: return protocol with user portfolio
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserProtocol'
description: Get the user's portfolio in the protocol
operationId: get_user_protocol
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: protocol_id
in: query
required: true
description: protocol id
schema:
type: string
tags:
- User
/v1/user/simple_protocol_list:
get:
responses:
'200':
description: return list of protocols with user assets
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserSimpleProtocol'
description: Stats the user's protocol assets on a chain
operationId: get_user_simple_protocol_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
tags:
- User
/v1/user/token:
get:
responses:
'200':
description: return user token balance of each chain
content:
application/json:
schema:
$ref: '#/components/schemas/UserToken'
description: Get user token balance
operationId: get_user_token
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
- name: token_id
in: query
required: true
description: token id
schema:
type: string
tags:
- User
/v1/user/token_authorized_list:
get:
responses:
'200':
description: return list of tokens with risk exposure
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserTokenAuthorized'
description: Show the user's risk exposure of approved token on a chain
operationId: get_user_token_authorized_list
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
tags:
- User
/v1/user/token_list:
get:
responses:
'200':
description: return user token balance list of each chain
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/UserToken'
description: Get user token balance
operationId: get_user_token_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
- name: chain_id
in: query
required: true
description: ChainID
schema:
type: string
- name: is_all
in: query
description: If true, all tokens are returned, including protocol-derived tokens
schema:
type: boolean
default: true
tags:
- User
/v1/user/total_balance:
get:
responses:
'200':
description: return the total net assets and the net assets of each chain
content:
application/json:
schema:
$ref: '#/components/schemas/UserTotalBalance'
description: Get net assets on multiple chains, including tokens and protocols
operationId: get_user_total_balance
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
tags:
- User
/v1/user/total_net_curve:
get:
responses:
'200':
description: Get the chain net curve
content:
application/json:
schema:
$ref: '#/components/schemas/NetCurve'
description: Get the chain net curve
operationId: get_total_chain_net_curve
parameters:
- name: id
in: query
required: true
description: User Address
schema:
type: string
- name: chain_ids
in: query
description: Chain ID List
style: form
explode: false
schema:
type: array
items:
type: string
default:
- merlin
- taiko
- celo
- zircuit
- xdc
- sonic
- scrl
- soneium
- avax
- arb
- katana
- cro
- blast
- sophon
- citrea
- dbk
- core
- bera
- bsc
- sei
- cfx
- g0
- uni
- eth
- hemi
- bb
- world
- tempo
- kite
- morph
- zora
- mnt
- kava
- zeta
- lisk
- matic
- rsk
- xlayer
- abs
- hyper
- metis
- mode
- btr
- megaeth
- story
- chiliz
- flr
- plume
- era
- op
- manta
- klay
- opbnb
- bob
- monad
- ethlink
- plasma
- gravity
- b2
- hood
- ink
- lens
- fuse
- itze
- base
- ron
- xdai
- linea
- ape
- stable
- wemix
- cyber
- frax
tags:
- User
/v1/user/used_chain_list:
get:
responses:
'200':
description: used chain list
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Chain'
description: Get user chain list
operationId: get_user_chain_list
parameters:
- name: id
in: query
required: true
description: Address
schema:
type: string
tags:
- User
components:
schemas:
UserHistory:
properties:
cate_dict:
type: object
description: cate_dict
history_list:
type: array
items:
$ref: '#/components/schemas/history_list'
project_dict:
type: object
description: project dict
token_dict:
type: object
description: token dict
type: object
sends:
properties:
amount:
type: number
example: 0.1
to_addr:
type: string
description: to_addr
example: '0x495f947276749ce646f68ac8c248420045cb7b5e'
token_id:
type: string
description: token_id
example: '0x495f947276749ce646f68ac8c248420045cb7b5e'
type: object
attributes:
properties:
trait_type:
type: string
description: trait_type
example: Artist
value:
type: object
example: SpaceTurtleShip
type: object
tx:
properties:
eth_gas_fee:
type: number
example: 0.002296035
usd_gas_fee:
type: number
example: 0.002296035
value:
type: number
example: 0.002296035
from_addr:
type: string
description: from_addr
example: '0x495f947276749ce646f68ac8c248420045cb7b5e'
to_addr:
type: string
description: to_addr
example: '0x495f947276749ce646f68ac8c248420045cb7b5e'
name:
type: string
example: transfer
status:
type: integer
example: 1
params:
type: array
items:
type: string
type: object
UserTotalBalance:
properties:
total_usd_value:
type: number
description: total usd value
example: '12000.123'
chain_list:
type: array
items:
$ref: '#/components/schemas/NewChain'
type: object
nft_contracts:
properties:
chain:
type: string
description: chain
example: eth
contract_name:
type: string
description: contract_name
example: OpenSea Shared Storefront
contract_id:
type: string
description: contract_id
example: '0x495f947276749ce646f68ac8c248420045cb7b5e'
is_erc1155:
type: boolean
description: is_erc1155
default: false
example: true
is_erc721:
type: boolean
description: is_erc721
default: false
example: true
amount:
type: string
description: amount
example: '1'
spenders:
type: array
items:
$ref: '#/components/schemas/Spenders'
type: object
UserApp:
properties:
id:
type: string
description: app id
example: hyperliquid
name:
type: string
example: Hyperliquid
logo_url:
type: string
example: https://static.debank.com/image/project/logo_url/arb_hyperliquid/98dcfcb24e1ec2ab0da74679e0bfa0bb.png
site_url:
type: string
description: Prioritize websites that can be interacted with, not official websites
example: https://app.hyperliquid.xyz
has_supported_portfolio:
type: boolean
description: Is portfolio already supported
example: true
portfolio_item_list:
type: array
items:
$ref: '#/components/schemas/PortfolioItem'
type: object
NetCurve:
properties:
timestamp:
type: number
description: time
example: '1669706400'
usd_value:
type: number
description: USD value
example: '12000.123'
type: object
nft_tokens:
properties:
id:
type: string
description: id
example: defc948fbe6d3b138b49bf981e276f0b
contract_id:
type: string
description: contract_id
example: '0x495f947276749ce646f68ac8c248420045cb7b5e'
inner_id:
type: string
description: inner_id
example: '55575360221028374465659771733000318579577403829328624053715758637886677712897'
chain:
type: string
description: chain
example: eth
name:
type: string
description: name
example: A New Era has begun
symbol:
type: string
description: symbol
example: UNI-V3-POS
total_supply:
type: integer
description: total_supply
example: 1000
description:
type: string
description: description
example: '3 of 9
On February 8, 2021'
content_type:
type: string
description: content_type
example: image_url
content:
type: string
description: content
example: https://lh3.googleusercontent.com/WQnK8JxSSPj5YIxegh9iaprMaMmv-JswrcnTp9Mi5PXKDWmigkOzTBBIAkhdXtLPe7EwIe6Q1gi2gdtLzV08d2y67rMVTHx0Ei0S
detail_url:
type: string
description: detail_url
example: https://opensea.io/assets/0x495f947276749ce646f68ac8c248420045cb7b5e/55575360221028374465659771733000318579577403829328624053715758637886677712897
contract_name:
type: string
description: contract_name
example: OpenSea Shared Storefront
is_erc1155:
type: boolean
description: is_erc1155
default: false
example: true
is_erc721:
type: boolean
description: is_erc721
default: false
amount:
type: string
description: amount
example: '1'
spenders:
type: array
items:
$ref: '#/components/schemas/Spenders'
type: object
Protocol2:
properties:
id:
type: string
description: contract id
example: uniswap3
name:
type: string
description: contract name
example: Uniswap V3
logo_url:
type: string
description: contract logo_url
example: https://static.debank.com/image/project/logo_url/uniswap3/87a541b3b83b041c8d12119e5a0d19f0.png
chain:
type: string
description: chain
example: eth
type: object
NewChain:
properties:
id:
type: string
description: chain id
example: eth
community_id:
type: integer
description: Community-identified id
example: 1
name:
type: string
example: Ethereum
logo_url:
type: string
example: https://static.debank.com/image/chain/logo_url/eth/6e0cd1f895af9836ee8c32cfc03bc279.png
native_token_id:
type: string
description: native token
example: eth
wrapped_token_id:
type: string
description: the erc20-wrapped of native token
example: '0xc02aaa39b223fe8d0a0e5c4f2
# --- truncated at 32 KB (46 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/debank/refs/heads/main/openapi/debank-user-api-openapi.yml