Get EVM Address Information#
Query basic information for an EVM address, including its native token balance, transaction count, first and last transaction times, and contract creation and call details for contract addresses. EVM chains only. If the address has no on-chain records, data returns an empty array.
Supported chains: see Get Address API Supported Chains (apiName: information-evm).
Request URL#
GET
https://web3.okx.com/api/v6/explorer/address/information-evmRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique identifier of the chain, e.g., 1 for ETH. EVM chains only. See Get Address API Supported Chains for supported values. |
| address | String | Yes | EVM address. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| address | String | Address. |
| isValidator | Boolean | Whether the address is a validator node. |
| balance | String | Native token balance. |
| balanceSymbol | String | Symbol of the native token balance (e.g., Gnosis chain returns ETH). |
| transactionCount | String | Number of transactions for the address. |
| firstTransactionTime | String | Time of the address's first transaction. |
| lastTransactionTime | String | Time of the address's most recent transaction. |
| contractAddress | Boolean | Whether the address is a contract address (used to determine whether it is an EOA). |
| createContractAddress | String | Address that created the contract. An empty string for non-contract addresses. |
| createContractTransactionHash | String | Transaction hash that created the contract. An empty string for non-contract addresses. |
| contractCorrespondingToken | String | Token corresponding to the contract. An empty string for non-contract addresses. |
| contractCalls | String | Number of contract calls. An empty string for non-contract addresses. |
| contractCallingAddresses | String | Number of addresses that have called the contract. An empty string for non-contract addresses. |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/address/information-evm?chainIndex=1&address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' \
--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'
Response Example#
json
{
"code": "0",
"msg": "",
"data": [
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"isValidator": false,
"balance": "744.5387964072138",
"balanceSymbol": "ETH",
"transactionCount": "1568",
"firstTransactionTime": "1438922865000",
"lastTransactionTime": "1753690000000",
"contractAddress": false,
"createContractAddress": "",
"createContractTransactionHash": "",
"contractCorrespondingToken": "",
"contractCalls": "",
"contractCallingAddresses": ""
}
]
}