钱包 API

总估值#

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

请求地址#

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

请求参数#

ParameterTypeRequiredDescription
accountIdStringYes查账户总估值
chainsStringNo筛选需要查询总资产的链,多条链以","分隔。最多支持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?accountId=e7dba4c2-666d-496a-ad92-768d29291fee&chains=' \
--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": "1172.895057177065864522056725546579939398"
        }
    ]
}