Batch Get Normal Transaction List by Address#
Query the normal transaction list for multiple addresses within a given block range in batches. Up to 50 addresses are allowed, and the block range must not span more than 10,000 blocks. Results are returned with cursor + limit pagination. Supports EVM-compatible chains and TRON.
Supported chains: see Get Transaction API Supported Chains (apiName: normal-transaction-list-multi).
Request URL#
GET
https://web3.okx.com/api/v6/explorer/transaction/normal-transaction-list-multiRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique identifier of the chain, e.g., 1 for ETH and 0 for BTC. See Get Transaction API Supported Chains for supported values. |
| address | String | Yes | Address. Separate multiple addresses with commas, up to 50; duplicate addresses are deduplicated automatically. |
| startBlockHeight | String | Yes | Start block height. The range between this and endBlockHeight must not span more than 10,000 blocks. |
| endBlockHeight | String | Yes | End block height. |
| isFromOrTo | String | No | from: return only transactions where the from address is the queried address; to: return only transactions where the to address is the queried address. If omitted, a match on either from or to is returned. |
| limit | String | No | Number of entries per page. Default is 20, maximum is 100. |
| cursor | String | No | Cursor returned by the previous response. Omit it for the first page. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| limit | String | Maximum number of entries on this page. |
| cursor | String | Cursor for the next page; an empty string means no more pages. Pass it back as-is; clients should not parse or construct it. |
| transactionList | Array | Transaction list. |
| > txId | String | Transaction hash. |
| > methodId | String | Method ID; an empty string when the transaction is not a contract call. |
| > blockHash | String | Block hash. |
| > height | String | Block height. |
| > transactionTime | String | Transaction time, as a Unix timestamp in milliseconds. |
| > from | String | Sender address. |
| > to | String | Recipient address. |
| > isFromContract | Boolean | Whether the from address is a contract address. |
| > isToContract | Boolean | Whether the to address is a contract address. |
| > amount | String | Transaction amount. |
| > symbol | String | Symbol of the currency the transaction amount is denominated in. |
| > txFee | String | Transaction fee. |
| > gasLimit | String | Gas limit. |
| > gasUsed | String | Gas used. |
| > gasPrice | String | Gas price. |
| > nonce | String | Sequence number of the transaction sent from the initiating address. |
| > transactionType | String | Transaction type. |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/transaction/normal-transaction-list-multi?chainIndex=1&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045,0x282edab8a933bc1c02649fe3ea2842ecb8e26183&startBlockHeight=18717000&endBlockHeight=18718000' \
--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": [
{
"limit": "20",
"cursor": "",
"transactionList": [
{
"txId": "0x9d918f5c1b0b04b8f5b0a2e6d9c78a3f5f89f24d43be3fb4b17e58fcbb42a95b",
"methodId": "",
"blockHash": "0x4a151d9d3e1b7fca2f9f34ea70e2ae35b6f4cd8e4a1cdbedb50ac52c1c50b1af",
"height": "18717042",
"transactionTime": "1702138715000",
"from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"to": "0x282edab8a933bc1c02649fe3ea2842ecb8e26183",
"isFromContract": false,
"isToContract": false,
"amount": "0.1",
"symbol": "ETH",
"txFee": "0.000893972405466",
"gasLimit": "21000",
"gasUsed": "21000",
"gasPrice": "42570114546",
"nonce": "1178",
"transactionType": "2"
}
]
}
]
}