

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Casos de uso con Amazon Managed Blockchain (AMB) Query
<a name="query-usecases"></a>

En este tema se proporciona una lista de los casos de uso de AMB Query.

**Topics**
+ [Consulta los saldos actuales e históricos de los tokens](#query-token-balances)
+ [Recupera datos históricos de transacciones](#query-transactions)
+ [Obtenga todos los saldos simbólicos de una dirección determinada](#query-token-balances)
+ [Enumere los eventos emitidos para una transacción](#query-tokens-minted)
+ [Obtenga todos los tokens acuñados mediante un contrato](#query-transaction-events)
+ [Enumere los contratos y obtenga información sobre los contratos](#query-contract-info)

## Consulta los saldos actuales e históricos de los tokens
<a name="query-token-balances"></a>

La [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTokenBalance.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTokenBalance.html)API obtiene el saldo de los tokens admitidos (ERC20, ERC721, ERC1155) y las monedas nativas (ETH, BTC) para obtener el saldo actual o histórico mediante una marca de tiempo universal (marca de tiempo de Unix, en segundos) de cuentas de propiedad externa (). EOAs Por ejemplo, puedes usar la operación de la `GetTokenBalance` API para obtener el saldo de direcciones del ERC20 token, el USDC, en la red principal de Ethereum. También puedes recuperar por lotes los saldos de los tokens y las monedas nativas mediante la operación de API. `BatchGetTokenBalance`

Para obtener más información, consulte la [Guía de referencia de consultas de Amazon Managed Blockchain (AMB)](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html).

## Recupera datos históricos de transacciones
<a name="query-transactions"></a>

Con Amazon Managed Blockchain (AMB) Query, puede recuperar datos históricos de cadenas de bloques públicas como Ethereum y Bitcoin. Esta función permite varios casos de uso, como recuperar el historial de transacciones en una cartera de cadena de bloques o proporcionar información contextual sobre una transacción en función de su hash de transacción. Puedes usar la operación de [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactions.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactions.html)API para obtener una lista de transacciones de una dirección de propiedad externa (EOA) determinada en la red principal de Ethereum y, luego, puedes usar la operación de [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTransaction.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_GetTransaction.html)API para recuperar los detalles de la transacción de una sola transacción de la lista. 

Para obtener más información, consulte la [Guía de referencia de consultas de Amazon Managed Blockchain (AMB)](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html).

## Obtenga todos los saldos simbólicos de una dirección determinada
<a name="query-token-balances"></a>

Puede usar la operación de la [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html)API para obtener saldos en carteras, interfaces de usuario, utilidades web3 y más. Esta operación de API devuelve una lista de todos los saldos de una dirección entre los tokens (ERC20, ERC721, ERC1155) y las monedas nativas (ETH, BTC) de una cadena de bloques pública determinada mediante una sola operación de API. Por ejemplo, puedes proporcionar una dirección de propiedad externa (EOA) y una red (la red principal de Ethereum) y, en la respuesta, puedes recibir una lista de los saldos de tokens y monedas nativas.

Para obtener más información, consulte la [Guía de referencia de consultas de Amazon Managed Blockchain (AMB)](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html).

## Enumere los eventos emitidos para una transacción
<a name="query-tokens-minted"></a>

Puede utilizar la operación de [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html)API para recuperar una lista de los eventos contractuales que se emiten como resultado de una transacción determinada, identificados por su hash (identificador de transacción). Por ejemplo, puedes utilizarla [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTransactionEvents.html)para recuperar los eventos resultantes de una transacción que invoque una función de un contrato ERC20 simbólico en la cadena de bloques de Ethereum, como un evento de *transferencia* o un evento de *retirada* del ERC20 contrato.

Para obtener más información, consulte la [Guía de referencia de consultas de Amazon Managed Blockchain (AMB)](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html).

## Obtenga todos los tokens acuñados mediante un contrato
<a name="query-transaction-events"></a>

Puede utilizar la operación de [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html)API para obtener una lista de todos los tokens admitidos (ERC20, ERC721, ERC1155) acuñados por un contrato cuando se introduce la dirección del contrato. Por ejemplo, puedes recuperar información relacionada con los tokens no fungibles (NFTs) acuñados según el estándar ERC721 contractual de la cadena de bloques de Ethereum mediante la operación de API. [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/API_ListTokenBalances.html)

Para obtener más información, consulte la [Guía de referencia de consultas de Amazon Managed Blockchain (AMB)](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html).

## Enumere los contratos y obtenga información sobre los contratos
<a name="query-contract-info"></a>

Puede usar la operación de [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html)API para enumerar los contratos ERC-721, ERC-1155 o ERC-20 implementados por una dirección determinada. Además, si tienes la dirección del contrato, puedes usar la operación de [https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/ListAssetContracts.html)API para recuperar las propiedades del contrato, como el tipo de contrato, la dirección del implementador y los metadatos del token relevantes.

Para obtener más información, consulte la [Guía de referencia de consultas de Amazon Managed Blockchain (AMB)](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html).