Query Account Balance by Token#
Query the total balance of certain specified tokens under a wallet account or watch-only account.
Request Path#
POST https://www.okx.com/api/v5/wallet/asset/token-balances
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| accountId | String | Yes | Unique identifier for the account |
| tokenAddresses | Array | Yes | List of tokens. Maximum list size is 20 |
| >chainIndex | String | Yes | Unique identifier for the chain |
| >tokenAddress | String | Yes | Token address. Pass an empty string "" to represent the mainnet native token. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| tokenAssets | Array | List for token balances |
| >chainIndex | String | Unique identifier for the chain |
| >tokenAddress | String | Contract address |
| >symbol | String | Token symbol |
| >balance | String | Token balance |
| >tokenPrice | String | Token price in USD |
| >tokenType | String | Token type: 1: token 2: inscription |
| >isRiskToken | Boolean | true: flagged as a risk airdrop token false: not flagged |
Request Example#
shell
curl --location --request POST 'https://www.okx.com/api/v5/wallet/asset/token-balances' \
--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' \
--data-raw '{
"accountId": "4686531e-3adb-469a-8000-8fd1c2097f68",
"tokenAddresses": [
{
"chainIndex": "1",
"tokenAddress": ""
},
{
"chainIndex": "0",
"tokenAddress": "btc-brc20-psat"
}
]
}'
Response Example#
200
{
"code": "0",
"msg": "success",
"data": [
{
"tokenAssets": [
{
"chainIndex": "1",
"tokenAddress": "",
"symbol": "ETH",
"balance": "0.07210371955388872",
"tokenPrice": "2650.43",
"tokenType": "1",
"isRistToken": false
},
{
"chainIndex": "0",
"tokenAddress": "btc-brc20-psat",
"symbol": "psat",
"balance": "1",
"tokenPrice": "140",
"tokenType": "2",
"isRiskToken": false
},
]
}
]
}