获取地址历史余额#

查询地址在指定区块高度时的本链币或代币余额（历史余额）。本接口为高级版接口。仅支持部分公链（BTC、ETH、TRON、BSC 等）。

支持的链：见获取区块 API 支持的链（apiName：address-balance-history）。

请求地址#

GET

https://web3.okx.com/api/v6/explorer/block/address-balance-history

请求参数#

参数名	类型	是否必填	描述
chainIndex	String	是	链唯一标识，如 ETH 为 1、BTC 为 0；支持范围见获取区块 API 支持的链
height	String	是	区块高度（纯数字），查询该高度时的余额
address	String	是	查询余额的地址
tokenContractAddress	String	否	代币合约地址；不传时查询本链币余额
project	String	否	项目标识

响应参数#

参数名	类型	描述
address	String	查询余额的地址
height	String	查询余额的区块高度
balance	String	余额
balanceRaw	String	原始余额（无小数，最小单位）
balanceSymbol	String	余额币种：本链币查询时为本链代币名称，指定代币查询时为代币缩写名称
tokenContractAddress	String	代币合约地址；本链币查询时为空串 ""
blockTime	String	该区块的出块时间；Unix 时间戳的毫秒数格式，如 1597026383085

请求示例#shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/block/address-balance-history?chainIndex=1&height=19000000&address=0x28c6c06298d514db089934071355e5743bf21d60' \
--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'
响应示例#json
{
    "code": "0",
    "msg": "",
    "data": [
        {
            "address": "0x28c6c06298d514db089934071355e5743bf21d60",
            "height": "19000000",
            "balance": "123456.735278657822018352",
            "balanceRaw": "123456735278657822018352",
            "balanceSymbol": "ETH",
            "tokenContractAddress": "",
            "blockTime": "1705146239000"
        }
    ]
}
上一頁获取区块统计数据下一頁交易 API 参考