Get Address Transaction List#
Get the transaction list for a TradeZone address with optional filtering by protocol type, token contract, block range, and direction.
Request Path#
GET
https://web3.okx.com/api/v5/xlayer/tz/address/transaction-listRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainShortName | String | Yes | The abbreviated name of the blockchain network, e.g, TRADE_ZONE |
| address | String | Yes | The address to query |
| startBlockHeight | Long | No | Start block height (inclusive) |
| endBlockHeight | Long | No | End block height (inclusive) |
| limit | Integer | No | The number of results returned per request. The maximum is 100. The default is 20. |
| page | Integer | No | Page number, default 1 |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| page | String | Current page number |
| limit | String | Number of results per page |
| totalPage | String | Total number of pages |
| total | String | Total number of records |
| data | Array | Transaction list |
| > hash | String | Transaction hash |
| > blockHeight | String | Block height |
| > blockHash | String | Block hash |
| > blockTime | String | Block time (ms) |
| > status | String | Transaction status: 0x1 success / 0x0 failure |
| > from | String | Business executing user address |
| > actionType | String | Action type |
| > index | String | Execution order |
| > value | String | Transaction amount (token precision applied) |
| > valueRaw | String | Transaction amount (raw integer, smallest unit) |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/tz/address/transaction-list?chainShortName=TRADE_ZONE&address=0x7ad674c0595de0885f7335b8dcaa91ca5d1723e5&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": "9341",
"total": "9341",
"data": [
{
"hash": "0x11d02c8e2b830265507b0dfc467900f30c1e729359e660a84bcc2f3b1e1b8f34",
"blockHeight": "21321328",
"blockHash": "0x61b22ea3b0a64ff0a9110daaca7dca77e6ba8e2324057ddbc929a3ddf55d226e",
"blockTime": "1779167134517",
"status": "0x1",
"from": "0x7ad674c0595de0885f7335b8dcaa91ca5d1723e5",
"actionType": "updateOwner",
"index": "3",
"value": "",
"valueRaw": ""
}
]
}
]
}