钱包 API

总估值#

获取地址下全量 token 和 Defi 资产总余额,支持过滤垃圾空投代币。

请求地址#

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

请求参数#

ParameterTypeRequiredDescription
addressStringYes查地址总估值
chainsStringYes筛选需要查询总资产估值的链,多条链以","分隔。最多支持 50 个
assetTypeStringNo查询余额类型,默认查所有资产总余额。0:查询所有资产总余额,包括 token 和 defi 资产 1:只查 token 总余额 2:只查 defi 总余额
excludeRiskTokenBooleanNo可能存在风险空投代币,可选择是否过滤。默认过滤。true:过滤,false:不过滤"

响应参数#

ParameterTypeDescription
totalValueString根据查询类型返回资产总余额,以美元为单位返回

请求示例#

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'

响应示例#

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