Get Internal Transaction List By Address#
Get a list of internal transactions associated with an address.
Request Path#
GET
https://web3.okx.com/api/v5/xlayer/address/internal-transaction-listRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainShortName | String | Yes | The abbreviated name of the blockchain network |
| address | String | Yes | Address |
| startBlockHeight | String | No | The starting block height |
| endBlockHeight | String | No | The end block height |
| isFromOrTo | String | No | from, filter transactions where the from address is the query address. to, filter transactions where the to address is the query address |
| page | String | No | Page |
| limit | String | No | The number of results returned per request. The maximum is 50. The default is 20. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| page | String | Current page number |
| limit | String | The amount of data |
| totalPage | String | Total number of pages |
| transactionList | Array | Transaction list |
| > txid | String | Transaction hash |
| > blockHash | String | Block hash |
| > height | String | Block height |
| > transactionTime | String | The Unix timestamp of the transaction time, in milliseconds format, e.g., 1597026383085 |
| > from | String | Sender address |
| > to | String | Recipient address |
| > isFromContract | Bol | Is the From address a contract address |
| > isToContract | Bol | Is the To address a contract address |
| > operation | String | Operation type |
| > amount | String | Transaction amount |
| > state | String | Transaction status success fail |
| > symbol | String | Symbol of the token |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/address/internal-transaction-list?chainShortName=xlayer&address=0x1e4a5963abfd975d8c9021ce480b42188849d41d&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": [
{
"limit": "1",
"page": "1",
"totalPage": "10000",
"transactionList": [
{
"txId": "0x06eadc91e56112be1ea348fa61fc58b5aa4637dd128d9b823a876340d78157df",
"operation": "call",
"blockHash": "0xaebfc9302cce84b17cc14b6a865b7ee452ecfc58d1bd6e01d3a512a2d8878bae",
"height": "31276541",
"transactionTime": "1755569401000",
"from": "0x8869230d573bc68446d4a4a3e08ff93a5d59e797",
"to": "0x1e4a5963abfd975d8c9021ce480b42188849d41d",
"isFromContract": true,
"isToContract": true,
"amount": "0",
"symbol": "OKB",
"state": "success"
}
]
}
]
}