Total Value#

Get the total balance of all tokens and DeFi assets under the specified address, with support for filtering out risk airdrop tokens.

Request URL#

GET https://www.okx.com/api/v5/wallet/asset/total-value-by-address

Request Parameters#

Parameter	Type	Required	Description
address	String	Yes	Get the total valuation for the address
chains	String	Yes	Query the total balance of the multiple chains, which can be separated by ",". Supports up to 50 chains
assetType	String	No	Type of asset to query, defaults to total balance of all assets. 0: Query total balance of all assets, including tokens and DeFi assets; 1: Query only token balance; 2: Query only DeFi balance
excludeRiskToken	Boolean	No	Option to filter out potentially risky airdrop tokens. Defaults to filtering. true: filter, false: do not filter

Response Parameters#

Parameter	Type	Description
totalValue	String	Returns the total asset balance based on the query asset type, expressed in USD

Request Example#

shell

curl --location --request GET 'https://www.okx.com/api/v5/wallet/asset/total-value-by-address?address=0x0b32aa5c1e71715206fe29b7badb21ad95f272c0&chains=1&assetType=0' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'

Response Example#

200

{
    "code": "0",
    "msg": "success",
    "data": [
        {
            "totalValue": "172.895057177065864522056725546579939398"
        }
    ]
}