Get Transaction List#
Get the TradeZone transaction list, optionally filtered by block hash, transaction hash, or block height.
Request Path#
GET
https://web3.okx.com/api/v5/xlayer/tz/transaction/transaction-listRequest Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainShortName | String | Yes | The abbreviated name of the blockchain network, e.g, TRADE_ZONE |
| blockHash | String | No | Filter by block hash |
| height | Integer | No | Filter by block height |
| 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/transaction/transaction-list?chainShortName=TRADE_ZONE&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": "4479103",
"total": "4479103",
"data": [
{
"hash": "0x3f0519739cbbc1583e1c10c4028300176a82ec910f7a72e31b1a59c2236565e9",
"blockHeight": "21326728",
"blockHash": "0xe7ecaea8cbbe2d54ec29db5068f50ce21829aeee09cac0ce2e51d42ead34908e",
"blockTime": "1779167674517",
"status": "0x1",
"from": "0x7ad674c0595de0885f7335b8dcaa91ca5d1723e5",
"actionType": "updateOwner",
"index": "3",
"value": "",
"valueRaw": ""
}
]
}
]
}