介绍

获取总估值#

获取地址下全量代币和 Defi 资产总余额。

请求地址#

GET https://web3.okx.com/api/v5/dex/balance/total-value-by-address

请求参数#

Parameter	Type	Required	Description
address	String	是	查地址总估值
chains	String	是	筛选需要查询总资产估值的链，多条链以","分隔。最多支持 50 个。(如`1`代表Ethereum。更多可查看这里。)
assetType	String	否	查询余额类型，默认查所有资产总余额。 `0`：查询所有资产总余额，包括代币和 defi 资产 `1`：只查代币总余额 `2`：只查 defi 总余额
excludeRiskToken	Boolean	否	是否过滤风险空投代币和貔貅盘代币。默认过滤。 `true`:过滤，`false`:不过滤对于貔貅盘代币，目前只支持 `ETH`、`BSC`、`SOL`、`BASE` 四条链，更多的链即将被支持。

响应参数#

Parameter	Type	Description
totalValue	String	根据查询类型返回资产总余额，以美元为单位返回

获取支持的链

获取资产明细

请求示例#

shell

curl --location --request GET 'https://web3.okx.com/api/v5/de x/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'

响应示例#

200

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

获取支持的链

获取资产明细