资产明细#
查询地址持有的多个链或指定链的 token 余额列表。 余额查询支持：
- 主链币
- EVM 链的 ERC20 代币
- Bitcoin 链的 BRC-20、ARC-20、Runes 和 SRC-20 代币
- Fractal Bitcoin 链的 BRC-20 代币
此外，该接口支持过滤风险空投代币。
请求路径#
GET https://www.okx.com/api/v5/wallet/asset/all-token-balances-by-address
请求参数#
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | String | Yes | 地址 |
| chains | String | Yes | 筛选需要查询资产明细的链，多条链以","分隔。最多支持 50 个 |
| filter | String | No | 0: 过滤风险空投币 1: 不过滤风险空投币 默认过滤 |
响应参数#
| Parameter | Type | Description |
|---|---|---|
| tokenAssets | Array | 代币余额 |
| >chainIndex | String | 链唯一标识 |
| >tokenAddress | String | 合约地址 |
| >address | String | 地址 |
| >symbol | String | 代币简称 |
| >balance | String | 代币数量 |
| >rawBalance | String | 代币的原始数量。更多的链即将被支持。对于不支持的链，该字段为空。 |
| >tokenPrice | String | 币种单位价值，以美元计价 |
| >tokenType | String | 币种类型: 1：token 2：铭文 |
| >transferAmount | String | BRC-20、FBRC-20 等铭文资产可直接转账、交易的余额数量，一般称为可转余额。 |
| >availableAmount | String | BRC-20、FBRC-20 等铭文资产需要完成铭刻操作才可以交易、转账的数量，一般称为可用余额或者待铭刻余额。 |
| >isRiskToken | Boolean | true：命中风险空投币 false：未命中风险空投币 |
请求示例#
shell
curl --location --request GET 'https://www.okx.com/api/v5/wallet/asset/all-token-balances-by-address?address=0xEd0C6079229E2d407672a117c22b62064f4a4312&chains=1&filter=1' \
--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": "success",
"data": [
{
"tokenAssets": [
{
"chainIndex": "1",
"tokenAddress": "0x386ae941d4262b0ee96354499df2ab8442734ec0",
"symbol": "PT-sUSDE-27FEB2025",
"balance": "47042180.520700015",
"tokenPrice": "0.968391562089677097",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
"symbol": "wstETH",
"balance": "7565.892480395067",
"tokenPrice": "4321.611627695311",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
"symbol": "WBTC",
"balance": "329.10055205",
"tokenPrice": "98847.8",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x23878914efe38d27c4d67ab83ed1b93a74d4086a",
"symbol": "aEthUSDT",
"balance": "30057379.938443",
"tokenPrice": "0.99978",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x657e8c867d8b37dcc18fa4caead9c45eb088c642",
"symbol": "eBTC",
"balance": "271.94970471",
"tokenPrice": "99094.345321371",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x4d5f47fa6a74757f35c14fd3a6ef8e3c9bc514e8",
"symbol": "aEthWETH",
"balance": "6080.001975381972",
"tokenPrice": "3634.32",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xe00bd3df25fb187d6abbb620b3dfd19839947b81",
"symbol": "PT-sUSDE-27MAR2025",
"balance": "19016580.895408865",
"tokenPrice": "0.952031186961110727",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xa17581a9e3356d9a858b789d68b4d866e593ae94",
"symbol": "cWETHv3",
"balance": "3000.000734740809",
"tokenPrice": "3663.74",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x9d39a5de30e57443bff2a8307a4256c8797a3497",
"symbol": "sUSDe",
"balance": "4863500.628333919",
"tokenPrice": "1.144688569528375454",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xec5a52c685cc3ad79a6a347abace330d69e0b1ed",
"symbol": "PT-LBTC-27MAR2025",
"balance": "46.02912324",
"tokenPrice": "97165.169717785655331396",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x8236a87084f8b84306f72007f36f2618a5634494",
"symbol": "LBTC",
"balance": "38.09998",
"tokenPrice": "99187.19184268864",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xbeef047a543e45807105e51a8bbefcc5950fcfba",
"symbol": "steakUSDT",
"balance": "482651.8612595832",
"tokenPrice": "1.063",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x4c9edd5852cd905f086c759e8383e09bff1e68b3",
"symbol": "USDe",
"balance": "69564",
"tokenPrice": "0.99977",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x8be3460a480c80728a8c4d7a5d5303c85ba7b3b9",
"symbol": "sENA",
"balance": "42294.989425",
"tokenPrice": "1.19",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "",
"symbol": "ETH",
"balance": "8.135546539084933",
"tokenPrice": "3638.63",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xbf5495efe5db9ce00f80364c8b423567e58d2110",
"symbol": "ezETH",
"balance": "5.270854886240325",
"tokenPrice": "3763.152404188635320082",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
"symbol": "DAI",
"balance": "1196.2693184870445",
"tokenPrice": "1.0002",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xc00e94cb662c3520282e6f5717214004a7f26888",
"symbol": "COMP",
"balance": "0.007643",
"tokenPrice": "84.43345772756197",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x9abfc0f085c82ec1be31d30843965fcc63053ffe",
"symbol": "Q*",
"balance": "900",
"tokenPrice": "0.000419255747329174",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xa1290d69c65a6fe4df752f95823fae25cb99e5a7",
"symbol": "rsETH",
"balance": "0.00007090104120006",
"tokenPrice": "3765.640772858747921444",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x56015bbe3c01fe05bc30a8a9a9fd9a88917e7db3",
"symbol": "CAT",
"balance": "0.42",
"tokenPrice": "0.06242994543936436",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xec53bf9167f50cdeb3ae105f56099aaab9061f83",
"symbol": "EIGEN",
"balance": "0.002496149915967488",
"tokenPrice": "4.018538365202288",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x58d97b57bb95320f9a05dc918aef65434969c2b2",
"symbol": "MORPHO",
"balance": "0.001409373661132556",
"tokenPrice": "3.3568669630371337",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xaf5191b0de278c7286d6c7cc6ab6bb8a73ba2cd6",
"symbol": "STG",
"balance": "0.000009547670354338",
"tokenPrice": "0.49707759500034454",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xba3335588d9403515223f109edc4eb7269a9ab5d",
"symbol": "GEAR",
"balance": "0.000009005734110189",
"tokenPrice": "0.012329598382413718",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x35fa164735182de50811e8e2e824cfb9b6118ac2",
"symbol": "eETH",
"balance": "0.000000000000000001",
"tokenPrice": "3637.93",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
"symbol": "stETH",
"balance": "0.000000000000000001",
"tokenPrice": "3637.93",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xa3931d71877c0e7a3148cb7eb4463524fec27fbd",
"symbol": "sUSDS",
"balance": "67435907.43236613",
"tokenPrice": "0",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xa8705a14c79fa1cded70875510211fec822b3c30",
"symbol": "BEEX",
"balance": "5000000",
"tokenPrice": "0",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0xabc0abace9fb9625fcefbedc423e8f94225bd251",
"symbol": "TANUKI",
"balance": "3548102.746002181",
"tokenPrice": "0",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
},
{
"chainIndex": "1",
"tokenAddress": "0x356b8d89c1e1239cbbb9de4815c39a1474d5ba7d",
"symbol": "syrupUSDT",
"balance": "1750000",
"tokenPrice": "0",
"tokenType": "1",
"isRiskToken": false,
"transferAmount": "0",
"availableAmount": "0",
"rawBalance": "",
"address": "0xed0c6079229e2d407672a117c22b62064f4a4312"
}
]
}
]
}