按钱包账户查余额#

查询钱包账户下，持有的多个链或指定链的代币余额列表。

余额查询支持：

主链币
EVM 链的 ERC20 代币
Bitcoin 生态的 BRC-20、ARC-20、Runes 和 SRC-20 代币

注意

对于钱包账户，查询的币种需要先通过添加币种的接口进行添加。

请求路径#

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	币种单位价值，以美元计价

请求示例#

shell

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'

响应示例#

200

{
    "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"
}