Get Internal Transactions By Address And Block#
You can perform a batch query for up to 20 addresses' regular transactions. You need to limit the query to a starting and ending block height, and the difference between the two cannot exceed 10,000 blocks.
Request Path#
GET
https://web3.okx.com/api/v5/xlayer/address/internal-transaction-list-multiRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainShortName | String | Yes | The abbreviated name of the blockchain network, e.g, XLAYER |
| address | String | Yes | Addresses, up to 20 can be entered, separated by commas |
| startBlockHeight | String | Yes | The start block height for the search |
| endBlockHeight | String | Yes | The end block height for the search |
| page | String | No | Page number |
| limit | String | No | Number of results per page. The default minimum is 20 and the maximum is 100 |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| page | String | Current page number |
| limit | String | Number of results per page. The default minimum is 20 and the maximum is 100 |
| totalPage | String | Total number of pages |
| transactionList | Array | List of transactions |
| > txId | String | Transaction hash |
| > blockHash | String | Block hash |
| > height | String | Block height where the transaction occurred |
| > operation | String | Operation type (e.g., staticcall) |
| > from | String | Transaction origin addresses, multiple addresses can be separated by commas |
| > to | String | Transaction destination addresses, multiple addresses can be separated by commas |
| > isFromContract | Bool | Whether the 'from' address is a contract address |
| > isToContract | Bool | Whether the 'to' address is a contract address |
| > amount | String | Amount of tokens involved in the transaction |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/address/internal-transaction-list-multi?chainShortName=xlayer&address=0x1e4a5963abfd975d8c9021ce480b42188849d41d,0x74b7f16337b8972027f6196a17a631ac6de26d22&endBlockHeight=18374470&startBlockHeight=18370000&limit=1' \
--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": [
{
"page": "1",
"limit": "1",
"totalPage": "24",
"transactionList": [
{
"txId": "0xb3419122edd3f45387d4cf8603b45003d514fd7ba9c1c5218d88f6d284905693",
"blockHash": "0x1fa9214b1cfaafa7fcb3fcd9200e5ca2bd59e59e76360a67a4fa797707772079",
"height": "18372896",
"transactionTime": "1750114210000",
"operation": "call",
"from": "0xc7545904de04200b3d4676827cdc9977a0d032d5",
"to": "0x1e4a5963abfd975d8c9021ce480b42188849d41d",
"isFromContract": true,
"isToContract": true,
"amount": "0"
}
]
}
]
}