翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Managed Blockchain (AMB) クエリのユースケース
このトピックでは、AMB クエリのユースケースを一覧表示します。
**Topics**
+ [現在および過去のトークン残高をクエリする](#query-token-balances)
+ [履歴トランザクションデータを取得する](#query-transactions)
+ [特定のアドレスのすべてのトークン残高を取得する](#query-token-balances)
+ [トランザクションに対して出力されたイベントを一覧表示する](#query-tokens-minted)
+ [契約によって作成されたすべてのトークンを取得する](#query-transaction-events)
+ [契約を一覧表示し、契約情報を取得する](#query-contract-info)
## 現在および過去のトークン残高をクエリする
[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 は、サポートされているトークン (ERC20、ERC721, ERC1155とネイティブコイン (ETH、BTC) のバランスを取得し、外部所有アカウント (EOAs) のユニバーサルタイムスタンプ (Unix タイムスタンプ、秒単位) を使用して、現在または過去のバランスを取得します。たとえば、 `GetTokenBalance` API オペレーションを使用して、Ethereum Mainnet の ERC20 トークン USDC のアドレスバランスを取得できます。`BatchGetTokenBalance` API オペレーションを使用して、トークンとネイティブコインのバランスをバッチ取得することもできます。
詳細については、[「Amazon Managed Blockchain (AMB) クエリリファレンスガイド](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)」を参照してください。
## 履歴トランザクションデータを取得する
Amazon Managed Blockchain (AMB) クエリを使用すると、Ethereum や Bitcoin などのパブリックブロックチェーンから履歴データを取得できます。この機能により、ブロックチェーンウォレットのトランザクション履歴の取得や、トランザクションハッシュに基づくトランザクションに関するコンテキスト情報の提供など、いくつかのユースケースが可能になります。[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 オペレーションを使用して Ethereum Mainnet 上の特定の外部所有アドレス (EOA) のトランザクションのリストを取得し、[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 オペレーションを使用してリストから 1 つのトランザクションのトランザクションの詳細を取得できます。
詳細については、[「Amazon Managed Blockchain (AMB) クエリリファレンスガイド](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)」を参照してください。
## 特定のアドレスのすべてのトークン残高を取得する
[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 オペレーションを使用して、ウォレット、ユーザーインターフェイス、web3 ユーティリティなどの残高を取得できます。この API オペレーションは、単一の API オペレーションを使用して、特定のパブリックブロックチェーン上のトークン (ERC20、ERC721, ERC1155) とネイティブコイン (ETH、BTC) にわたるアドレスのすべての残高のリストを返します。たとえば、外部所有のアドレス (EOA) とネットワーク (Ethereum Mainnet) を指定し、レスポンスでトークンとネイティブコインバランスのリストを受け取ることができます。
詳細については、[「Amazon Managed Blockchain (AMB) クエリリファレンスガイド](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)」を参照してください。
## トランザクションに対して出力されたイベントを一覧表示する
[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 オペレーションを使用して、ハッシュ (トランザクション識別子) によって識別される、特定のトランザクションの結果として出力される契約イベントのリストを取得できます。たとえば、 [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)を使用して、ERC20 契約からの*転送*イベントや*取り消し*イベントなど、Ethereum ブロックチェーンで ERC20 トークン契約の関数を呼び出すトランザクションの結果イベントを取得できます。
詳細については、[「Amazon Managed Blockchain (AMB) クエリリファレンスガイド](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)」を参照してください。
## 契約によって作成されたすべてのトークンを取得する
[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 オペレーションを使用して、契約アドレスを入力として渡したときに、契約によって作成されたすべてのサポートされているトークン (ERC20、ERC721, ERC1155のリストを返すことができます。例えば、 [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 オペレーションを使用して、Ethereum ブロックチェーンの ERC721 契約標準によって作成された非ファンジブルトークン (NFTs) に関する情報を取得できます。
詳細については、[「Amazon Managed Blockchain (AMB) クエリリファレンスガイド](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)」を参照してください。
## 契約を一覧表示し、契約情報を取得する
[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 オペレーションを使用して、特定のアドレスによってデプロイされた ERC-721, ERC-1155、または ERC-20 契約を一覧表示できます。さらに、契約アドレスがある場合は、 [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 オペレーションを使用して、契約タイプのデプロイ先のアドレスや関連するトークンメタデータなど、契約のプロパティを取得できます。
詳細については、[「Amazon Managed Blockchain (AMB) クエリリファレンスガイド](https://docs.aws.amazon.com/managed-blockchain/latest/AMBQ-APIReference/Welcome.html)」を参照してください。