# Data Types
<a name="API_Types"></a>

The Amazon Managed Blockchain Query API contains several data types that various actions use. This section describes each data type in detail.

**Note**  
The order of each element in a data type structure is not guaranteed. Applications should not assume a particular order.

The following data types are supported:
+  [AddressIdentifierFilter](API_AddressIdentifierFilter.md) 
+  [AssetContract](API_AssetContract.md) 
+  [BatchGetTokenBalanceErrorItem](API_BatchGetTokenBalanceErrorItem.md) 
+  [BatchGetTokenBalanceInputItem](API_BatchGetTokenBalanceInputItem.md) 
+  [BatchGetTokenBalanceOutputItem](API_BatchGetTokenBalanceOutputItem.md) 
+  [BlockchainInstant](API_BlockchainInstant.md) 
+  [ConfirmationStatusFilter](API_ConfirmationStatusFilter.md) 
+  [ContractFilter](API_ContractFilter.md) 
+  [ContractIdentifier](API_ContractIdentifier.md) 
+  [ContractMetadata](API_ContractMetadata.md) 
+  [ListFilteredTransactionEventsSort](API_ListFilteredTransactionEventsSort.md) 
+  [ListTransactionsSort](API_ListTransactionsSort.md) 
+  [OwnerFilter](API_OwnerFilter.md) 
+  [OwnerIdentifier](API_OwnerIdentifier.md) 
+  [TimeFilter](API_TimeFilter.md) 
+  [TokenBalance](API_TokenBalance.md) 
+  [TokenFilter](API_TokenFilter.md) 
+  [TokenIdentifier](API_TokenIdentifier.md) 
+  [Transaction](API_Transaction.md) 
+  [TransactionEvent](API_TransactionEvent.md) 
+  [TransactionOutputItem](API_TransactionOutputItem.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 
+  [VoutFilter](API_VoutFilter.md) 

# AddressIdentifierFilter
<a name="API_AddressIdentifierFilter"></a>

This is the container for the unique public address on the blockchain.

## Contents
<a name="API_AddressIdentifierFilter_Contents"></a>

 ** transactionEventToAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-AddressIdentifierFilter-transactionEventToAddress"></a>
The container for the recipient address of the transaction.   
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

## See Also
<a name="API_AddressIdentifierFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/AddressIdentifierFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/AddressIdentifierFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/AddressIdentifierFilter) 

# AssetContract
<a name="API_AssetContract"></a>

This container contains information about an contract.

## Contents
<a name="API_AssetContract_Contents"></a>

 ** contractIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-AssetContract-contractIdentifier"></a>
The container for the contract identifier containing its blockchain network and address.  
Type: [ContractIdentifier](API_ContractIdentifier.md) object  
Required: Yes

 ** deployerAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-AssetContract-deployerAddress"></a>
The address of the contract deployer.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

 ** tokenStandard **   <a name="ManagedBlockchainQueryAPIReference-Type-AssetContract-tokenStandard"></a>
The token standard of the contract.  
Type: String  
Valid Values: `ERC20 | ERC721 | ERC1155`   
Required: Yes

## See Also
<a name="API_AssetContract_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/AssetContract) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/AssetContract) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/AssetContract) 

# BatchGetTokenBalanceErrorItem
<a name="API_BatchGetTokenBalanceErrorItem"></a>

Error generated from a failed `BatchGetTokenBalance` request.

## Contents
<a name="API_BatchGetTokenBalanceErrorItem_Contents"></a>

 ** errorCode **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceErrorItem-errorCode"></a>
The error code associated with the error.  
Type: String  
Required: Yes

 ** errorMessage **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceErrorItem-errorMessage"></a>
The message associated with the error.  
Type: String  
Required: Yes

 ** errorType **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceErrorItem-errorType"></a>
The type of error.  
Type: String  
Valid Values: `VALIDATION_EXCEPTION | RESOURCE_NOT_FOUND_EXCEPTION`   
Required: Yes

 ** atBlockchainInstant **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceErrorItem-atBlockchainInstant"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

 ** ownerIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceErrorItem-ownerIdentifier"></a>
The container for the owner identifier.  
Type: [OwnerIdentifier](API_OwnerIdentifier.md) object  
Required: No

 ** tokenIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceErrorItem-tokenIdentifier"></a>
The container for the identifier for the token including the unique token ID and its blockchain network.  
Only the native tokens BTC and ETH, and the ERC-20, ERC-721, and ERC 1155 token standards are supported.
Type: [TokenIdentifier](API_TokenIdentifier.md) object  
Required: No

## See Also
<a name="API_BatchGetTokenBalanceErrorItem_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/BatchGetTokenBalanceErrorItem) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/BatchGetTokenBalanceErrorItem) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/BatchGetTokenBalanceErrorItem) 

# BatchGetTokenBalanceInputItem
<a name="API_BatchGetTokenBalanceInputItem"></a>

The container for the input for getting a token balance.

## Contents
<a name="API_BatchGetTokenBalanceInputItem_Contents"></a>

 ** ownerIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceInputItem-ownerIdentifier"></a>
The container for the owner identifier.  
Type: [OwnerIdentifier](API_OwnerIdentifier.md) object  
Required: Yes

 ** tokenIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceInputItem-tokenIdentifier"></a>
The container for the identifier for the token including the unique token ID and its blockchain network.  
Only the native tokens BTC and ETH, and the ERC-20, ERC-721, and ERC 1155 token standards are supported.
Type: [TokenIdentifier](API_TokenIdentifier.md) object  
Required: Yes

 ** atBlockchainInstant **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceInputItem-atBlockchainInstant"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

## See Also
<a name="API_BatchGetTokenBalanceInputItem_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/BatchGetTokenBalanceInputItem) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/BatchGetTokenBalanceInputItem) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/BatchGetTokenBalanceInputItem) 

# BatchGetTokenBalanceOutputItem
<a name="API_BatchGetTokenBalanceOutputItem"></a>

The container for the properties of a token balance output.

## Contents
<a name="API_BatchGetTokenBalanceOutputItem_Contents"></a>

 ** atBlockchainInstant **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceOutputItem-atBlockchainInstant"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: Yes

 ** balance **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceOutputItem-balance"></a>
The container for the token balance.  
Type: String  
Required: Yes

 ** lastUpdatedTime **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceOutputItem-lastUpdatedTime"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

 ** ownerIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceOutputItem-ownerIdentifier"></a>
The container for the owner identifier.  
Type: [OwnerIdentifier](API_OwnerIdentifier.md) object  
Required: No

 ** tokenIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-BatchGetTokenBalanceOutputItem-tokenIdentifier"></a>
The container for the identifier for the token including the unique token ID and its blockchain network.  
Only the native tokens BTC and ETH, and the ERC-20, ERC-721, and ERC 1155 token standards are supported.
Type: [TokenIdentifier](API_TokenIdentifier.md) object  
Required: No

## See Also
<a name="API_BatchGetTokenBalanceOutputItem_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/BatchGetTokenBalanceOutputItem) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/BatchGetTokenBalanceOutputItem) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/BatchGetTokenBalanceOutputItem) 

# BlockchainInstant
<a name="API_BlockchainInstant"></a>

The container for time.

## Contents
<a name="API_BlockchainInstant_Contents"></a>

 ** time **   <a name="ManagedBlockchainQueryAPIReference-Type-BlockchainInstant-time"></a>
The container of the `Timestamp` of the blockchain instant.  
This `timestamp` will only be recorded up to the second.
Type: Timestamp  
Required: No

## See Also
<a name="API_BlockchainInstant_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/BlockchainInstant) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/BlockchainInstant) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/BlockchainInstant) 

# ConfirmationStatusFilter
<a name="API_ConfirmationStatusFilter"></a>

The container for the `ConfirmationStatusFilter` that filters for the [https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality](https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality) of the results.

## Contents
<a name="API_ConfirmationStatusFilter_Contents"></a>

 ** include **   <a name="ManagedBlockchainQueryAPIReference-Type-ConfirmationStatusFilter-include"></a>
The container to determine whether to list results that have only reached [https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality](https://docs.aws.amazon.com/managed-blockchain/latest/ambq-dg/key-concepts.html#finality). Transactions that have reached finality are always part of the response.  
Type: Array of strings  
Array Members: Minimum number of 1 item.  
Valid Values: `FINAL | NONFINAL`   
Required: Yes

## See Also
<a name="API_ConfirmationStatusFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ConfirmationStatusFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ConfirmationStatusFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ConfirmationStatusFilter) 

# ContractFilter
<a name="API_ContractFilter"></a>

The contract or wallet address by which to filter the request.

## Contents
<a name="API_ContractFilter_Contents"></a>

 ** deployerAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractFilter-deployerAddress"></a>
The network address of the deployer.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractFilter-network"></a>
The blockchain network of the contract.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

 ** tokenStandard **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractFilter-tokenStandard"></a>
The container for the token standard.  
Type: String  
Valid Values: `ERC20 | ERC721 | ERC1155`   
Required: Yes

## See Also
<a name="API_ContractFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ContractFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ContractFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ContractFilter) 

# ContractIdentifier
<a name="API_ContractIdentifier"></a>

Container for the blockchain address and network information about a contract.

## Contents
<a name="API_ContractIdentifier_Contents"></a>

 ** contractAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractIdentifier-contractAddress"></a>
Container for the blockchain address about a contract.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractIdentifier-network"></a>
The blockchain network of the contract.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

## See Also
<a name="API_ContractIdentifier_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ContractIdentifier) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ContractIdentifier) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ContractIdentifier) 

# ContractMetadata
<a name="API_ContractMetadata"></a>

The metadata of the contract.

## Contents
<a name="API_ContractMetadata_Contents"></a>

 ** decimals **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractMetadata-decimals"></a>
The decimals used by the token contract.  
Type: Integer  
Required: No

 ** name **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractMetadata-name"></a>
The name of the token contract.  
Type: String  
Required: No

 ** symbol **   <a name="ManagedBlockchainQueryAPIReference-Type-ContractMetadata-symbol"></a>
The symbol of the token contract.  
Type: String  
Required: No

## See Also
<a name="API_ContractMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ContractMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ContractMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ContractMetadata) 

# ListFilteredTransactionEventsSort
<a name="API_ListFilteredTransactionEventsSort"></a>

Lists all the transaction events for an address on the blockchain.

**Note**  
This operation is only supported on the Bitcoin blockchain networks.

## Contents
<a name="API_ListFilteredTransactionEventsSort_Contents"></a>

 ** sortBy **   <a name="ManagedBlockchainQueryAPIReference-Type-ListFilteredTransactionEventsSort-sortBy"></a>
The container for determining how the results will be sorted.  
Type: String  
Valid Values: `blockchainInstant`   
Required: No

 ** sortOrder **   <a name="ManagedBlockchainQueryAPIReference-Type-ListFilteredTransactionEventsSort-sortOrder"></a>
The container for the *sort order* for `ListFilteredTransactionEvents`. The `SortOrder` field only accepts the values `ASCENDING` and `DESCENDING`. Not providing `SortOrder` will default to `ASCENDING`.  
Type: String  
Valid Values: `ASCENDING | DESCENDING`   
Required: No

## See Also
<a name="API_ListFilteredTransactionEventsSort_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ListFilteredTransactionEventsSort) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ListFilteredTransactionEventsSort) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ListFilteredTransactionEventsSort) 

# ListTransactionsSort
<a name="API_ListTransactionsSort"></a>

The container for determining how the list transaction result will be sorted.

## Contents
<a name="API_ListTransactionsSort_Contents"></a>

 ** sortBy **   <a name="ManagedBlockchainQueryAPIReference-Type-ListTransactionsSort-sortBy"></a>
Defaults to the value `TRANSACTION_TIMESTAMP`.  
Type: String  
Valid Values: `TRANSACTION_TIMESTAMP`   
Required: No

 ** sortOrder **   <a name="ManagedBlockchainQueryAPIReference-Type-ListTransactionsSort-sortOrder"></a>
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`.  
Type: String  
Valid Values: `ASCENDING | DESCENDING`   
Required: No

## See Also
<a name="API_ListTransactionsSort_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ListTransactionsSort) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ListTransactionsSort) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ListTransactionsSort) 

# OwnerFilter
<a name="API_OwnerFilter"></a>

The container for the owner information to filter by.

## Contents
<a name="API_OwnerFilter_Contents"></a>

 ** address **   <a name="ManagedBlockchainQueryAPIReference-Type-OwnerFilter-address"></a>
The contract or wallet address.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

## See Also
<a name="API_OwnerFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/OwnerFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/OwnerFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/OwnerFilter) 

# OwnerIdentifier
<a name="API_OwnerIdentifier"></a>

The container for the owner identifier.

## Contents
<a name="API_OwnerIdentifier_Contents"></a>

 ** address **   <a name="ManagedBlockchainQueryAPIReference-Type-OwnerIdentifier-address"></a>
The contract or wallet address for the owner.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

## See Also
<a name="API_OwnerIdentifier_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/OwnerIdentifier) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/OwnerIdentifier) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/OwnerIdentifier) 

# TimeFilter
<a name="API_TimeFilter"></a>

This container is used to specify a time frame.

## Contents
<a name="API_TimeFilter_Contents"></a>

 ** from **   <a name="ManagedBlockchainQueryAPIReference-Type-TimeFilter-from"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

 ** to **   <a name="ManagedBlockchainQueryAPIReference-Type-TimeFilter-to"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

## See Also
<a name="API_TimeFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/TimeFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/TimeFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/TimeFilter) 

# TokenBalance
<a name="API_TokenBalance"></a>

The balance of the token.

## Contents
<a name="API_TokenBalance_Contents"></a>

 ** atBlockchainInstant **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenBalance-atBlockchainInstant"></a>
The time for when the TokenBalance is requested or the current time if a time is not provided in the request.  
This time will only be recorded up to the second.
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: Yes

 ** balance **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenBalance-balance"></a>
The container of the token balance.  
Type: String  
Required: Yes

 ** lastUpdatedTime **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenBalance-lastUpdatedTime"></a>
The `Timestamp` of the last transaction at which the balance for the token in the wallet was updated.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

 ** ownerIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenBalance-ownerIdentifier"></a>
The container for the identifier of the owner.  
Type: [OwnerIdentifier](API_OwnerIdentifier.md) object  
Required: No

 ** tokenIdentifier **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenBalance-tokenIdentifier"></a>
The identifier for the token, including the unique token ID and its blockchain network.  
Type: [TokenIdentifier](API_TokenIdentifier.md) object  
Required: No

## See Also
<a name="API_TokenBalance_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/TokenBalance) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/TokenBalance) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/TokenBalance) 

# TokenFilter
<a name="API_TokenFilter"></a>

The container of the token filter like the contract address on a given blockchain network or a unique token identifier on a given blockchain network.

**Note**  
You must always specify the network property of this container when using this operation.

## Contents
<a name="API_TokenFilter_Contents"></a>

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenFilter-network"></a>
The blockchain network of the token.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

 ** contractAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenFilter-contractAddress"></a>
This is the address of the contract.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** tokenId **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenFilter-tokenId"></a>
The unique identifier of the token.  
Type: String  
Pattern: `[a-zA-Z0-9]{1,66}`   
Required: No

## See Also
<a name="API_TokenFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/TokenFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/TokenFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/TokenFilter) 

# TokenIdentifier
<a name="API_TokenIdentifier"></a>

The container for the identifier for the token including the unique token ID and its blockchain network.

**Note**  
Only the native tokens BTC and ETH, and the ERC-20, ERC-721, and ERC 1155 token standards are supported.

## Contents
<a name="API_TokenIdentifier_Contents"></a>

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenIdentifier-network"></a>
The blockchain network of the token.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

 ** contractAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenIdentifier-contractAddress"></a>
This is the token's contract address.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** tokenId **   <a name="ManagedBlockchainQueryAPIReference-Type-TokenIdentifier-tokenId"></a>
The unique identifier of the token.  
For native tokens, use the 3 character abbreviation that best matches your token. For example, btc for Bitcoin, eth for Ether, etc. For all other token types you must specify the `tokenId` in the 64 character hexadecimal `tokenid` format.
Type: String  
Pattern: `[a-zA-Z0-9]{1,66}`   
Required: No

## See Also
<a name="API_TokenIdentifier_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/TokenIdentifier) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/TokenIdentifier) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/TokenIdentifier) 

# Transaction
<a name="API_Transaction"></a>

There are two possible types of transactions used for this data type:
+ A Bitcoin transaction is a movement of BTC from one address to another.
+ An Ethereum transaction refers to an action initiated by an externally owned account, which is an account managed by a human, not a contract. For example, if Bob sends Alice 1 ETH, Bob's account must be debited and Alice's must be credited. This state-changing action occurs within a transaction.

## Contents
<a name="API_Transaction_Contents"></a>

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-network"></a>
The blockchain network where the transaction occurred.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

 ** numberOfTransactions **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-numberOfTransactions"></a>
The number of transactions in the block.  
Type: Long  
Required: Yes

 ** to **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-to"></a>
The identifier of the transaction. It is generated whenever a transaction is verified and added to the blockchain.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: Yes

 ** transactionHash **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-transactionHash"></a>
The hash of a transaction. It is generated when a transaction is created.  
Type: String  
Pattern: `(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})`   
Required: Yes

 ** transactionIndex **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-transactionIndex"></a>
The index of the transaction within a blockchain.  
Type: Long  
Required: Yes

 ** transactionTimestamp **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-transactionTimestamp"></a>
The `Timestamp` of the transaction.   
Type: Timestamp  
Required: Yes

 ** blockHash **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-blockHash"></a>
The block hash is a unique identifier for a block. It is a fixed-size string that is calculated by using the information in the block. The block hash is used to verify the integrity of the data in the block.  
Type: String  
Pattern: `(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})`   
Required: No

 ** blockNumber **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-blockNumber"></a>
The block number in which the transaction is recorded.  
Type: String  
Required: No

 ** confirmationStatus **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-confirmationStatus"></a>
Specifies whether the transaction has reached Finality.  
Type: String  
Valid Values: `FINAL | NONFINAL`   
Required: No

 ** contractAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-contractAddress"></a>
The blockchain address for the contract.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** cumulativeGasUsed **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-cumulativeGasUsed"></a>
The amount of gas used up to the specified point in the block.  
Type: String  
Required: No

 ** effectiveGasPrice **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-effectiveGasPrice"></a>
The effective gas price.  
Type: String  
Required: No

 ** executionStatus **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-executionStatus"></a>
Identifies whether the transaction has succeeded or failed.  
Type: String  
Valid Values: `FAILED | SUCCEEDED`   
Required: No

 ** from **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-from"></a>
The initiator of the transaction. It is either in the form a public key or a contract address.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** gasUsed **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-gasUsed"></a>
The amount of gas used for the transaction.  
Type: String  
Required: No

 ** signatureR **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-signatureR"></a>
The signature of the transaction. The X coordinate of a point R.  
Type: String  
Required: No

 ** signatureS **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-signatureS"></a>
The signature of the transaction. The Y coordinate of a point S.  
Type: String  
Required: No

 ** signatureV **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-signatureV"></a>
The signature of the transaction. The Z coordinate of a point V.  
Type: Integer  
Required: No

 ** transactionFee **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-transactionFee"></a>
The transaction fee.  
Type: String  
Required: No

 ** transactionId **   <a name="ManagedBlockchainQueryAPIReference-Type-Transaction-transactionId"></a>
The identifier of a Bitcoin transaction. It is generated when a transaction is created.  
Type: String  
Required: No

## See Also
<a name="API_Transaction_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/Transaction) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/Transaction) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/Transaction) 

# TransactionEvent
<a name="API_TransactionEvent"></a>

The container for the properties of a transaction event.

## Contents
<a name="API_TransactionEvent_Contents"></a>

 ** eventType **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-eventType"></a>
The type of transaction event.  
Type: String  
Valid Values: `ERC20_TRANSFER | ERC20_MINT | ERC20_BURN | ERC20_DEPOSIT | ERC20_WITHDRAWAL | ERC721_TRANSFER | ERC1155_TRANSFER | BITCOIN_VIN | BITCOIN_VOUT | INTERNAL_ETH_TRANSFER | ETH_TRANSFER`   
Required: Yes

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-network"></a>
The blockchain network where the transaction occurred.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

 ** transactionHash **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-transactionHash"></a>
The hash of a transaction. It is generated when a transaction is created.  
Type: String  
Pattern: `(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})`   
Required: Yes

 ** blockchainInstant **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-blockchainInstant"></a>
The container for time.  
Type: [BlockchainInstant](API_BlockchainInstant.md) object  
Required: No

 ** confirmationStatus **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-confirmationStatus"></a>
This container specifies whether the transaction has reached Finality.  
Type: String  
Valid Values: `FINAL | NONFINAL`   
Required: No

 ** contractAddress **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-contractAddress"></a>
The blockchain address for the contract  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** from **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-from"></a>
The wallet address initiating the transaction. It can either be a public key or a contract.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** spentVoutIndex **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-spentVoutIndex"></a>
The position of the spent transaction output in the output list of the *creating transaction*.  
This is only returned for `BITCOIN_VIN` event types.
Type: Integer  
Required: No

 ** spentVoutTransactionHash **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-spentVoutTransactionHash"></a>
The transactionHash that *created* the spent transaction output.  
This is only returned for `BITCOIN_VIN` event types.
Type: String  
Required: No

 ** spentVoutTransactionId **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-spentVoutTransactionId"></a>
The transactionId that *created* the spent transaction output.  
This is only returned for `BITCOIN_VIN` event types.
Type: String  
Required: No

 ** to **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-to"></a>
The wallet address receiving the transaction. It can either be a public key or a contract.  
Type: String  
Pattern: `[-A-Za-z0-9]{13,74}`   
Required: No

 ** tokenId **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-tokenId"></a>
The unique identifier for the token involved in the transaction.  
Type: String  
Pattern: `[a-zA-Z0-9]{1,66}`   
Required: No

 ** transactionId **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-transactionId"></a>
The identifier of a Bitcoin transaction. It is generated when a transaction is created.  
Type: String  
Required: No

 ** value **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-value"></a>
The value that was transacted.  
Type: String  
Required: No

 ** voutIndex **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-voutIndex"></a>
The position of the transaction output in the transaction output list.  
Type: Integer  
Required: No

 ** voutSpent **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionEvent-voutSpent"></a>
Specifies if the transaction output is spent or unspent. This is only returned for BITCOIN\$1VOUT event types.  
This is only returned for `BITCOIN_VOUT` event types.
Type: Boolean  
Required: No

## See Also
<a name="API_TransactionEvent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/TransactionEvent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/TransactionEvent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/TransactionEvent) 

# TransactionOutputItem
<a name="API_TransactionOutputItem"></a>

The container of the transaction output.

## Contents
<a name="API_TransactionOutputItem_Contents"></a>

 ** network **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionOutputItem-network"></a>
The blockchain network where the transaction occurred.  
Type: String  
Valid Values: `ETHEREUM_MAINNET | ETHEREUM_SEPOLIA_TESTNET | BITCOIN_MAINNET | BITCOIN_TESTNET`   
Required: Yes

 ** transactionHash **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionOutputItem-transactionHash"></a>
The hash of a transaction. It is generated when a transaction is created.  
Type: String  
Pattern: `(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})`   
Required: Yes

 ** transactionTimestamp **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionOutputItem-transactionTimestamp"></a>
The time when the transaction occurred.  
Type: Timestamp  
Required: Yes

 ** confirmationStatus **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionOutputItem-confirmationStatus"></a>
Specifies whether to list transactions that have not reached Finality.  
Type: String  
Valid Values: `FINAL | NONFINAL`   
Required: No

 ** transactionId **   <a name="ManagedBlockchainQueryAPIReference-Type-TransactionOutputItem-transactionId"></a>
The identifier of a Bitcoin transaction. It is generated when a transaction is created.  
Type: String  
Pattern: `(0x[A-Fa-f0-9]{64}|[A-Fa-f0-9]{64})`   
Required: No

## See Also
<a name="API_TransactionOutputItem_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/TransactionOutputItem) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/TransactionOutputItem) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/TransactionOutputItem) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

The resource passed is invalid.

## Contents
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="ManagedBlockchainQueryAPIReference-Type-ValidationExceptionField-message"></a>
The `ValidationException` message.  
Type: String  
Required: Yes

 ** name **   <a name="ManagedBlockchainQueryAPIReference-Type-ValidationExceptionField-name"></a>
The name of the field that triggered the `ValidationException`.  
Type: String  
Required: Yes

## See Also
<a name="API_ValidationExceptionField_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/ValidationExceptionField) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/ValidationExceptionField) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/ValidationExceptionField) 

# VoutFilter
<a name="API_VoutFilter"></a>

This container specifies filtering attributes related to `BITCOIN_VOUT` event types

## Contents
<a name="API_VoutFilter_Contents"></a>

 ** voutSpent **   <a name="ManagedBlockchainQueryAPIReference-Type-VoutFilter-voutSpent"></a>
Specifies if the transaction output is spent or unspent.  
Type: Boolean  
Required: Yes

## See Also
<a name="API_VoutFilter_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/managedblockchain-query-2023-05-04/VoutFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/managedblockchain-query-2023-05-04/VoutFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/managedblockchain-query-2023-05-04/VoutFilter)