ManagedBlockchainQuery / Client / list_transaction_events

list_transaction_events#

ManagedBlockchainQuery.Client.list_transaction_events(**kwargs)#

Lists all the transaction events for a transaction

Note

This action will return transaction details for all transactions that are confirmed on the blockchain, even if they have not reached finality.

See also: AWS API Documentation

Request Syntax

response = client.list_transaction_events(
    transactionHash='string',
    transactionId='string',
    network='ETHEREUM_MAINNET'|'ETHEREUM_SEPOLIA_TESTNET'|'BITCOIN_MAINNET'|'BITCOIN_TESTNET',
    nextToken='string',
    maxResults=123
)
Parameters:
  • transactionHash (string) – The hash of a transaction. It is generated when a transaction is created.

  • transactionId (string) –

    The identifier of a Bitcoin transaction. It is generated when a transaction is created.

    Note

    transactionId is only supported on the Bitcoin networks.

  • network (string) –

    [REQUIRED]

    The blockchain network where the transaction events occurred.

  • nextToken (string) – The pagination token that indicates the next set of results to retrieve.

  • maxResults (integer) –

    The maximum number of transaction events to list.

    Default: 100

    Note

    Even if additional results can be retrieved, the request can return less results than maxResults or an empty array of results.

    To retrieve the next set of results, make another request with the returned nextToken value. The value of nextToken is null when there are no more results to return

Return type:

dict

Returns:

Response Syntax

{
    'events': [
        {
            'network': 'ETHEREUM_MAINNET'|'ETHEREUM_SEPOLIA_TESTNET'|'BITCOIN_MAINNET'|'BITCOIN_TESTNET',
            'transactionHash': 'string',
            'eventType': 'ERC20_TRANSFER'|'ERC20_MINT'|'ERC20_BURN'|'ERC20_DEPOSIT'|'ERC20_WITHDRAWAL'|'ERC721_TRANSFER'|'ERC1155_TRANSFER'|'BITCOIN_VIN'|'BITCOIN_VOUT'|'INTERNAL_ETH_TRANSFER'|'ETH_TRANSFER',
            'from': 'string',
            'to': 'string',
            'value': 'string',
            'contractAddress': 'string',
            'tokenId': 'string',
            'transactionId': 'string',
            'voutIndex': 123,
            'voutSpent': True|False,
            'spentVoutTransactionId': 'string',
            'spentVoutTransactionHash': 'string',
            'spentVoutIndex': 123,
            'blockchainInstant': {
                'time': datetime(2015, 1, 1)
            },
            'confirmationStatus': 'FINAL'|'NONFINAL'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • events (list) –

      An array of TransactionEvent objects. Each object contains details about the transaction events.

      • (dict) –

        The container for the properties of a transaction event.

        • network (string) –

          The blockchain network where the transaction occurred.

        • transactionHash (string) –

          The hash of a transaction. It is generated when a transaction is created.

        • eventType (string) –

          The type of transaction event.

        • from (string) –

          The wallet address initiating the transaction. It can either be a public key or a contract.

        • to (string) –

          The wallet address receiving the transaction. It can either be a public key or a contract.

        • value (string) –

          The value that was transacted.

        • contractAddress (string) –

          The blockchain address for the contract

        • tokenId (string) –

          The unique identifier for the token involved in the transaction.

        • transactionId (string) –

          The identifier of a Bitcoin transaction. It is generated when a transaction is created.

        • voutIndex (integer) –

          The position of the transaction output in the transaction output list.

        • voutSpent (boolean) –

          Specifies if the transaction output is spent or unspent. This is only returned for BITCOIN_VOUT event types.

          Note

          This is only returned for BITCOIN_VOUT event types.

        • spentVoutTransactionId (string) –

          The transactionId that created the spent transaction output.

          Note

          This is only returned for BITCOIN_VIN event types.

        • spentVoutTransactionHash (string) –

          The transactionHash that created the spent transaction output.

          Note

          This is only returned for BITCOIN_VIN event types.

        • spentVoutIndex (integer) –

          The position of the spent transaction output in the output list of the creating transaction.

          Note

          This is only returned for BITCOIN_VIN event types.

        • blockchainInstant (dict) –

          The container for time.

          • time (datetime) –

            The container of the Timestamp of the blockchain instant.

            Note

            This timestamp will only be recorded up to the second.

        • confirmationStatus (string) –

          This container specifies whether the transaction has reached Finality.

    • nextToken (string) –

      The pagination token that indicates the next set of results to retrieve.

Exceptions

  • ManagedBlockchainQuery.Client.exceptions.ThrottlingException

  • ManagedBlockchainQuery.Client.exceptions.ValidationException

  • ManagedBlockchainQuery.Client.exceptions.AccessDeniedException

  • ManagedBlockchainQuery.Client.exceptions.InternalServerException

  • ManagedBlockchainQuery.Client.exceptions.ServiceQuotaExceededException