钱包 API
按余额查地址

按余额查地址#

查询钱包账户下,哪些地址有余额,按余额倒序返回。

请求路径#

GET https://www.okx.com/api/v5/wallet/asset/addresses-by-token-balance

请求参数#

ParameterTypeRequiredDescription
accountIdStringYes账户唯一标识
chainIndexStringYes链唯一标识
tokenAddressStringYes代币合约地址,查询哪些地址有该代币。传空则查询哪些地址有主链币余额
minBalanceStringYes最小余额,需要大于0
maxBalanceStringNo最大余额
limitStringNo每次查询多少条,默认值为 50,最大100

响应参数#

ParameterTypeDescription
addressString钱包账户下有余额的地址
valueString代币对应的余额
remarkString创建钱包时对地址的备注

请求示例#

shell
curl --location --request GET 'https://www.okx.com/api/v5/wallet/asset/addresses-by-token-balance?accountId=2a966196-cfe3-4932-b709-927232d87177&minBalance=337&maxBalance=29334620&chainIndex=1&limit=50&tokenAddress=0xdac17f958d2ee523a2206206994597c13d831ec7' \
--header 'Content-Type: application/json' \
--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": "",
    "data": [
                {
                    "address": "0xd9e497bd8f491fe163b42a62c296fb54caea74b7",
                    "value": "180920178",
                    "remark": "No17"
                },
                {
                    "address": "0x0kd697bd8f491fe163b42a62c296fb54caea98kd",
                    "value": "723189",
                    "remark": "No89"
                },
                {
                    "address": "0x238193be9e80e68eace3588b45d8cf4a7eae0fa3",
                    "value": "1129",
                    "remark": "No13"
                }
    ]
}