xrpl-dev-portal/content/references/http-websocket-apis/public-api-methods/account-methods/account_info.ja.md

html, parent, blurb, labels

html	parent	blurb	labels
account_info.html	account-methods.html	アカウントとそのアクティビティおよびXRP残高についての情報を取得します。	アカウント XRP

account_info

[ソース]

account_infoコマンドは、アカウントとそのアクティビティおよびXRP残高についての情報を取得します。取得されたすべての情報は、特定バージョンのレジャーに関連付けられています。

要求フォーマット

account_info要求の例:

WebSocket

{
  "id": 2,
  "command": "account_info",
  "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
  "strict": true,
  "ledger_index": "current",
  "queue": true
}

JSON-RPC

{
    "method": "account_info",
    "params": [
        {
            "account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "strict": true,
            "ledger_index": "current",
            "queue": true
        }
    ]
}

コマンドライン

#Syntax: account_info account [ledger_index|ledger_hash] [strict]
rippled account_info r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 true

試してみる>

要求には以下のパラメーターが含まれます。

Field	型	説明
account	文字列	アカウントの一意のIDであり、最もよく使用されるのはアカウントの[アドレス][]です。
strict	ブール値	（省略可能、デフォルトはFalse）Trueに設定すると、accountフィールドに指定できる項目は公開鍵またはXRP Ledgerアドレスのみになります。
ledger_hash	文字列	（省略可能） 使用するレジャーバージョンの20バイトの16進文字列。（[レジャーの指定][]を参照してください。)
ledger_index	文字列または符号なし整数	（省略可能） 使用するレジャーのシーケンス番号、またはレジャーを自動的に選択するためのショートカット文字列。（[レジャーの指定][]を参照してください。)
queue	ブール値	（省略可能） trueにして[FeeEscalation Amendment][]を有効にすると、このアカウントに関連するキューに入れられたトランザクションについてのステータスも返されます。これを使用できるのは、現在開いているレジャーのデータを問い合わせる場合のみです。[新規: rippled 0.33.0][]
signer_lists	ブール値	（省略可能）trueにして[MultiSign Amendment][]を有効にすると、このアカウントに関連するすべてのSignerListオブジェクトも返されます。[新規: rippled 0.31.0][]

次のフィールドは廃止予定のため、指定しないでください。ident、ledger。

応答フォーマット

処理が成功した応答の例:

WebSocket

{
    "id": 5,
    "status": "success",
    "type": "response",
    "result": {
        "account_data": {
            "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "Balance": "999999999960",
            "Flags": 8388608,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "4294BEBE5B569A18C0A2702387C9B1E7146DC3A5850C1E87204951C6FDAA4C42",
            "PreviousTxnLgrSeq": 3,
            "Sequence": 6,
            "index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
        },
        "ledger_current_index": 4,
        "queue_data": {
            "auth_change_queued": true,
            "highest_sequence": 10,
            "lowest_sequence": 6,
            "max_spend_drops_total": "500",
            "transactions": [
                {
                    "auth_change": false,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 6
                },
                ...(trimmed for length) ...
                {
                    "LastLedgerSequence": 10,
                    "auth_change": true,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 10
                }
            ],
            "txn_count": 5
        },
        "validated": false
    }
}

JSON-RPC

{
    "result": {
        "account_data": {
            "Account": "rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn",
            "Balance": "999999999960",
            "Flags": 8388608,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "4294BEBE5B569A18C0A2702387C9B1E7146DC3A5850C1E87204951C6FDAA4C42",
            "PreviousTxnLgrSeq": 3,
            "Sequence": 6,
            "index": "92FA6A9FC8EA6018D5D16532D7795C91BFB0831355BDFDA177E86C8BF997985F"
        },
        "ledger_current_index": 4,
        "queue_data": {
            "auth_change_queued": true,
            "highest_sequence": 10,
            "lowest_sequence": 6,
            "max_spend_drops_total": "500",
            "transactions": [
                {
                    "auth_change": false,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 6
                },
                ...(trimmed for length) ...
                {
                    "LastLedgerSequence": 10,
                    "auth_change": true,
                    "fee": "100",
                    "fee_level": "2560",
                    "max_spend_drops": "100",
                    "seq": 10
                }
            ],
            "txn_count": 5
        },
        "status": "success",
        "validated": false
    }
}

応答は[標準フォーマット][]に従い、要求されたアカウントとそのデータ、アカウントの適用先レジャーが結果として表示されます。以下のフィールドが含まれます。

Field	型	説明
account_data	オブジェクト	このアカウントの情報を含むAccountRootレジャーオブジェクトがレジャーに保管されているとおりに表示されます。
signer_lists	配列	（要求にsigner_listsが指定されていて、少なくとも1つのSignerListがアカウントに関連する場合を除いて省略されます。）マルチシグ用にアカウントに関連付けられたSignerListレジャーオブジェクトの配列。アカウントが所有できるSignerListは最大1つであるため、この配列のメンバーは存在するとすれば、1メンバーのみです。[新規: rippled 0.31.0][]
ledger_current_index	整数	（ledger_indexが代わりに指定されている場合は省略されます。）この情報を取得したときに使用されていた最新のレジャーのシーケンス番号。この情報には、これより新しいレジャーの変更は一切含まれません。
ledger_index	整数	（ledger_current_indexが代わりに指定されている場合は省略されます。）この情報を取得したときに使用されていたレジャーのシーケンス番号。この情報には、これより新しいレジャーの変更は一切含まれません。
queue_data	オブジェクト	（queueがtrueと指定され、現在開いているレジャーを問い合わせている場合を除いて省略されます。）このアカウントによって送信されたキューに入れられたトランザクションについての情報。この情報にはローカルrippledサーバーの状態が示されますが、コンセンサスネットワーク内の他のサーバーとは異なる場合があります。示される値はキューイングメカニズムによって「大まかに」計算されるため、一部のフィールドは省略される場合があります。
validated	ブール値	このデータが検証済みのレジャーバージョンのものである場合はTrueです。省略されているかFalseが設定されている場合、このデータは最終のものではありません。[新規: rippled 0.26.0][]

queue_dataパラメーターが存在する場合、以下のフィールドが含まれます。

Field	型	説明
txn_count	整数	このアドレスからキューに入れられたトランザクションの数。
auth_change_queued	ブール値	（省略される場合があります）キュー内のトランザクションがこのアドレスのトランザクションの承認方法を変更するかどうかを示します。trueの場合、トランザクションが実行されているかキューから除外されるまで、このアドレスはトランザクションをこれ以上キューに入れることができません。
lowest_sequence	整数	（省略される場合があります）このアドレスによってキューに入れられたトランザクションのうち最も低い[シーケンス番号][]。
highest_sequence	整数	（省略される場合があります）このアドレスによってキューに入れられたトランザクションのうち最も高い[シーケンス番号][]。
max_spend_drops_total	文字列	（省略される場合があります）キュー内のすべてのトランザクションが利用可能なXRPを最大限消費する場合に、このアドレスから差し引くことができる[XRPのdrop数][]を示す整数の金額。
transactions	配列	（省略される場合があります）このアドレスからキューに入れられた各トランザクションについての情報。

transactions配列内の各オブジェクト（存在する場合）には、以下のフィールドのいずれかまたはすべてが含まれます。

Field	型	説明
auth_change	ブール値	このトランザクションがこのアドレスのトランザクション承認の方法を変更するかどうかを示します。
fee	文字列	このトランザクションのトランザクションコスト（[XRPのdrop数][]）。
fee_level	文字列	このタイプのトランザクションの最少コストと比較した、このトランザクションのトランザクションコスト（手数料レベル）。
max_spend_drops	文字列	このトランザクションで送信または消却できる[XRPのdrop数][]の最高額。
seq	整数	このトランザクションの[シーケンス番号][]。

考えられるエラー

• いずれかの[汎用エラータイプ][]。
• invalidParams - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。例えば、要求でqueueをtrueと指定したが、現在開いているレジャーではないledger_indexを指定した場合です。
• actNotFound - 要求のaccountフィールドに指定したアドレスが、レジャー内のアカウントに対応していません。
• lgrNotFound - ledger_hashまたはledger_indexで指定したレジャーが存在しないか、存在してはいるもののサーバーが保有していません。

{% include '_snippets/rippled_versions.md' %} {% include '_snippets/rippled-api-links.md' %}