Get Contract Event Logs

1. Overview & Typical Use

Batch-query event logs and trigger transactions for a contract. Supports filtering by transaction hash, block number, and event name, with optional field projection.

Typical use: monitor contract events, view recent contract trigger transactions, batch-query contract execution logs by hash.
When not to use: for basic contract information only use “Get Contract Details”; for contract call statistics use “Get Contract Call Statistics”.

2. Endpoint & Authentication

POST /api/contracts/smart-contract-triggers-batch

For Base URL and authentication, see Common Network & Authentication.

3. Request

Fields

Parameter	Type	Required	Default	Description
`contractAddress`	string	No	—	Contract address
`hashList`	array	No	—	List of transaction hashes
`term`	string	No	—	Query keyword — supports block number and event name
`fields`	string	No	—	Comma-separated field names to include in `list[]` items

4. Response

Fields

Top-level

Field	Type	Required	Description	Unit/Precision
`event_list`	array	Required	Event log list	—
`list`	array	Required	Trigger transaction list	—

event_list[] elements

Field	Type	Required	Description	Unit/Precision
`block_number`	integer	Required	Block height	—
`block_timestamp`	integer	Required	Block time	Millisecond timestamp
`caller_contract_address`	string	Required	Caller contract address	—
`contract_address`	string	Required	Target contract address	—
`event_index`	integer	Required	Index position of the event within the transaction	—
`event_name`	string	Required	Event name	—
`event`	string	Required	Full event signature	—
`result`	object	Required	Event parameter key-value pairs (includes numeric index keys and named keys)	—
`result_type`	object	Required	Event parameter type mapping	—
`result_with_topic`	object	Required	Structured event parameters with topics (contains `index` array, `topic` hash, `dataInArr` array)	—
`transaction_id`	string	Required	Transaction hash	—

list[] elements

Field	Type	Required	Description	Unit/Precision
`owner_address`	string	Required	Transaction initiator address	—
`block`	integer	Required	Block height	—
`hash`	string	Required	Transaction hash	—
`date_created`	integer	Required	Creation time	Millisecond timestamp
`contract_address`	string	Required	Contract address	—
`token_id`	integer	Required	Token ID (typically 0)	—
`token_value`	integer	Required	Token transfer amount (typically 0)	—
`call_value`	integer	Required	TRX call value	sun
`data`	string	Required	Raw call data (hex-encoded)	—
`parameter`	string	Required	Decoded parameters (JSON string)	—
`method`	string	Required	Called method signature	—
`day`	string	Required	Transaction date	`YYYY-MM-DD`
`confirmed`	boolean	Required	Whether confirmed	—

Example


{
  "event_list": [
    {
      "block_number": 83067271,
      "block_timestamp": 1779870537000,
      "caller_contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "event_index": 0,
      "event_name": "Transfer",
      "result": {
        "0": "0x548d203d11f31b5ecdd991da8a6be6d695fd4ee4",
        "1": "0x732c2d4ff31fae914f0ac027071de7b084f78035",
        "2": "948000000",
        "from": "0x548d203d11f31b5ecdd991da8a6be6d695fd4ee4",
        "to": "0x732c2d4ff31fae914f0ac027071de7b084f78035",
        "value": "948000000"
      },
      "result_type": { "from": "address", "to": "address", "value": "uint256" },
      "result_with_topic": {
        "index": [
          {"param": "from", "value": "0x548d203d11f31b5ecdd991da8a6be6d695fd4ee4"},
          {"param": "to",   "value": "0x732c2d4ff31fae914f0ac027071de7b084f78035"}
        ],
        "topic": "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "dataInArr": [{"param": "value", "value": "948000000"}]
      },
      "event": "Transfer(address indexed from, address indexed to, uint256 value)",
      "transaction_id": "0f65d7592de08e7599dc6c486106d985e5e26608451597c7c3cccf04f5d5d592"
    }
  ],
  "list": [
    {
      "owner_address": "TJczL6NzR8rX4A9ESURkrnrJQtngwaFBuG",
      "block": 83067277,
      "hash": "1f17cf1ad525c18c60712dbc9adfa03d9cb0a7436088d3bf4a7213f5a9e0fbf9",
      "date_created": 1779870555000,
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "token_id": 0,
      "token_value": 0,
      "call_value": 0,
      "data": "a9059cbb000000000000000000000041151606cd44d392c23d6ca16ad1ae36571e412c7b0000000000000000000000000000000000000000000000000000000008f0d180",
      "confirmed": false,
      "method": "transfer(address _to,uint256 _value)",
      "parameter": "{\"0\":\"TBthaX8duoZcPhJp8DjoHUUU84ecVJZvS8\",\"1\":\"150000000\",\"_value\":\"150000000\",\"_to\":\"TBthaX8duoZcPhJp8DjoHUUU84ecVJZvS8\"}",
      "day": "2026-05-27"
    }
  ]
}

5. Errors

For HTTP status codes, see Common Errors. Key points for this endpoint:

Must use POST: a GET request will return an error.
Empty result is not an error: no matching events returns 200 + empty arrays — this is a normal response.