ManagedBlockchainQuery / Client / list_transactions

list_transactions#

ManagedBlockchainQuery.Client.list_transactions(**kwargs)#

Lists all the transaction events for a transaction.

See also: AWS API Documentation

Request Syntax

response = client.list_transactions(
    address='string',
    network='ETHEREUM_MAINNET'|'ETHEREUM_SEPOLIA_TESTNET'|'BITCOIN_MAINNET'|'BITCOIN_TESTNET',
    fromBlockchainInstant={
        'time': datetime(2015, 1, 1)
    },
    toBlockchainInstant={
        'time': datetime(2015, 1, 1)
    },
    sort={
        'sortBy': 'TRANSACTION_TIMESTAMP',
        'sortOrder': 'ASCENDING'|'DESCENDING'
    },
    nextToken='string',
    maxResults=123,
    confirmationStatusFilter={
        'include': [
            'FINAL'|'NONFINAL',
        ]
    }
)
Parameters:
  • address (string) –

    [REQUIRED]

    The address (either a contract or wallet), whose transactions are being requested.

  • network (string) –

    [REQUIRED]

    The blockchain network where the transactions occurred.

  • fromBlockchainInstant (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.

  • toBlockchainInstant (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.

  • sort (dict) –

    The order by which the results will be sorted.

    • sortBy (string) –

      Defaults to the value TRANSACTION_TIMESTAMP.

    • sortOrder (string) –

      The container for the sort order for ListTransactions. The SortOrder field only accepts the values ASCENDING and DESCENDING. Not providing SortOrder will default to ASCENDING.

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

  • maxResults (integer) –

    The maximum number of transactions 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

  • confirmationStatusFilter (dict) –

    This filter is used to include transactions in the response that haven’t reached finality. Transactions that have reached finality are always part of the response.

    • include (list) – [REQUIRED]

      The container to determine whether to list results that have only reached finality. Transactions that have reached finality are always part of the response.

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'transactions': [
        {
            'transactionHash': 'string',
            'transactionId': 'string',
            'network': 'ETHEREUM_MAINNET'|'ETHEREUM_SEPOLIA_TESTNET'|'BITCOIN_MAINNET'|'BITCOIN_TESTNET',
            'transactionTimestamp': datetime(2015, 1, 1),
            'confirmationStatus': 'FINAL'|'NONFINAL'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • transactions (list) –

      The array of transactions returned by the request.

      • (dict) –

        The container of the transaction output.

        • 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.

        • network (string) –

          The blockchain network where the transaction occurred.

        • transactionTimestamp (datetime) –

          The time when the transaction occurred.

        • confirmationStatus (string) –

          Specifies whether to list transactions that have not 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