查询钱包代币/铭文资产#
查询指定钱包下有所有资产、某条链的资产，或某个指定代币的资产。
请求地址#
POST https://www.okx.com/api/v5/waas/asset/get-assets
请求参数#
| Parameter | Type | Required | Description |
|---|---|---|---|
| walletId | String | Yes | 钱包唯一标识 |
| chainIds | Array<String> | No | 链唯一标识列表 (如有，且没有 coinId 维度的，则按 chainId 维度查询) |
| coinIds | Array<String> | No | 币种信息 (如有，则按 coinid 维度查询) |
响应参数#
| Parameter | Type | Description |
|---|---|---|
| tokenAssets | Array<String> | 代币资产 |
| >chainId | String | 链唯一标识 |
| >name | String | 某条链的地址 |
| >symbol | String | 代币简称 |
| >balance | String | 代币余额 |
| >coinId | String | 代币唯一标识 |
| >coinPrice | String | 币种单价（usd） |
| brc20TokenAssets | Array<String> | BRC20代币资产 |
| >chainId | String | 链唯一标识 |
| >name | String | 某条链的地址 |
| >symbol | String | 代币简称 |
| >totalBalance | String | 代币总余额 |
| >coinId | String | 代币唯一标识 |
| >coinPrice | String | 币种单价（usd） |
| >availableBalance | String | 可铭刻余额 |
| >transferableBalance | String | 可交易余额 |
请求示例#
shell
curl --location --request POST 'https://www.okx.com/api/v5/waas/asset/get-assets' \
--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 '{
"walletId": "13886e05-1265-4b79-8ac3-b7ab46217655",
"chainIds":["1"]
"coinIds":["1"]
}'
响应示例#
200
{
"code": "0",
"msg": "success",
"data": [
{
"tokenAssets": [
{
"address": "0xa64f953f379087b1e51b64ca12704b5af2cf0dd8",
"chainId": "1",
"coinId": "130",
"symbol": "PMA",
"balance": "395145.756353546338598187",
"coinPrice": "0.000001882732934029"
},
{
"address": "0xa64f953f379087b1e51b64ca12704b5af2cf0dd8",
"chainId": "56",
"coinId": "5036",
"symbol": "SAFEMOON",
"balance": "2903240.945298975",
"coinPrice": "0.000000003621432734"
},
{
"address": "bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u",
"chainId": "0",
"coinId": "1",
"symbol": "BTC",
"balance": "0.00311441",
"coinPrice": "41645.8"
}
],
"brc20TokenAssets": [
{
"address": "bc1psnr548clz3f4fz6jmpnw5eqzj2v2musk082wp8fvq5ac3p5ete6qg05u8u",
"chainId": "0",
"coinId": "1115139",
"symbol": "tokb",
"totalBalance": "10.00000000000000000", // DEPLOY max
"availableBalance": "3.00000000000000000", //剩余可造币量 Remaining mintable amt
"transferableBalance": "7.00000000000000000",//已inscribe为可转让的金额 Amt that already inscribed as transferable
"coinPrice": "0"
}
]
}
]
}