查询钱包账户下,持有的多个链或指定链的代币余额列表。
余额查询支持:
GET https://www.okx.com/api/v5/wallet/asset/all-token-balances
Parameter | Type | Required | Description |
---|---|---|---|
accountId | String | Yes | 账户唯一标识。 |
chains | Array | No | chainIndex列表,可以链维度过滤查询代币的展示。列表元素上限是 20 个 |
limit | String | No | 每次查询多少条, 默认 50,最大 100 |
cursor | String | No | 游标位置,默认为第一个 |
Parameter | Type | Description |
---|---|---|
cursor | String | 游标位置 |
tokenAssets | Array | 代币资产列表 |
>chainIndex | String | 链唯一标识 |
>tokenType | String | 币种类型: 1 : token 2 : 铭文 3 : LP token |
>tokenAddress | String | 合约地址 |
>symbol | String | 代币简称 |
>balance | String | 代币数量 |
>tokenPrice | String | 币种单位价值,以美元计价 |
curl --location --request GET 'https://www.okx.com/api/v5/wallet/asset/all-token-balances?accountId=44486e05-3235-2f8e-5fe2-a8ab46217863&chains=1,2' \
--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'
{
"code": "0",
"data": [
{
"cursor":"23",
"tokenAssets":[
{
"chainIndex": "1",
"tokenType": "0",
"tokenAddress": "",
"symbol":"ETH",
"balance":"1.2",
"tokenPrice": "3899.00",
},
{
"chainIndex": "1",
"tokenType": "2",
"tokenAddress": "0xe466b8eaa1851e27047ba0f956e5110cf4d27f19",
"symbol":"pufETH",
"balance":"1.2",
"tokenPrice": "3899.00",
},
{
"chainIndex": "0",
"tokenType": "1",
"tokenAddress": "",
"symbol":"ordi",
"balance":"58909090",
"tokenPrice": "21834.85",
}
]
}
]
"msg": "success"
}