account_tx

account_txメソッドは、指定したアカウントに関連するトランザクションのリストを取得します。

リクエストのフォーマット

リクエストのフォーマットの例:

{
  "id": 2,
  "command": "account_tx",
  "account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w",
  "ledger_index_min": -1,
  "ledger_index_max": -1,
  "binary": false,
  "limit": 2,
  "forward": false,
  "api_version": 2
}

試してみる >

リクエストには以下のパラメーターが含まれます。

`Field`	型	説明
`account`	文字列	アカウントの一意のIDであり、最も一般的なアカウントのアドレスが使用されます。
`tx_type`	文字列	(省略可) Clioのみ "Clawback"、"AccountSet"、"AccountDelete "など、特定のタイプのトランザクションのみを返します。 See Transaction Types. 新規: Clio v2.0 AMMのサポート: Clio v2.1.0
`ledger_index_min`	整数	（省略可能）含めるトランザクションのレジャーのうち最古のものを指定するのに使用します。`-1`の値は、使用可能な検証済みレジャーのうち最古のバージョンを使用するよう、サーバに指示します。
`ledger_index_max`	整数	（省略可能）含めるトランザクションのレジャーのうち最新のものを指定するのに使用します。`-1`の値は、使用可能な検証済みレジャーのうち最新のバージョンを使用するよう、サーバに指示します。
`ledger_hash`	文字列	（省略可能）単一のレジャーからのみトランザクションを検索するのに使用します。（レジャーの指定をご覧ください）
`ledger_index`	文字列または符号なし整数	（省略可能）単一のレジャーからのみトランザクションを検索するのに使用します。（レジャーの指定をご覧ください）
`binary`	ブール値	（省略可能）デフォルトは`false`です。`true`に設定すると、JSONの代わりに16進文字列でトランザクションが返されます。
`forward`	ブール値	（省略可能）デフォルトは`false`です。`true`に設定すると、最も古いレジャーを先頭としてインデックスが付けられた値が返されます。そうしない場合、最新のレジャーを先頭として結果にインデックスが付けられます。（結果を示した各ページの中身は順序よく整理されていない場合がありますが、ページ全体としては順序付けされています。）
`limit`	整数	（省略可能）デフォルトは変化します。取得するトランザクションの数を制限します。サーバはこの値を受け入れる必要はありません。
`marker`	マーカー	以前にページネーションされたレスポンスの値。そのレスポンスを停止した箇所からデータの取得を再開します。サーバが使用できるレジャーの範囲に変更があっても、この値は変わりません。

リクエスト内で次の各フィールドのうち1つ以上を使用する必要があります: ledger_index、ledger_hash、ledger_index_min、またはledger_index_max。
API v2： ledger_indexとledger_hashのどちらかを指定した場合、ledger_index_minとledger_index_maxを含めるとinvalidParamsエラーが返ります。

照会されたデータの繰り返し

他のページネーションメソッドと同様に、markerフィールドを使用すると複数ページのデータが返されます。

複数のリクエストの合間に、"ledger_index_min": -1と"ledger_index_max": -1が変更されて、以前とは異なるレジャーバージョンを参照する場合があります。markerフィールドを使用すると、リクエストからのレジャー範囲に変更がある場合でも、マーカーが示すポイントがリクエストで指定されたレジャーの範囲外でない限り、安全にページネーションできます。

レスポンスのフォーマット

処理が成功したレスポンスの例:

{
  "result": {
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
    "ledger_index_min": 32570,
    "ledger_index_max": 91824401,
    "transactions": [
      {
        "meta": {
          "AffectedNodes": [
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                  "AccountTxnID": "932CC7E9BAC1F7B9FA5381679F293EEC0A646E5E7F2F6D14C85FEE2102F0E66C",
                  "Balance": "1086222646",
                  "Domain": "6D64756F31332E636F6D",
                  "EmailHash": "98B4375E1D753E5B91627516F6D70977",
                  "Flags": 9568256,
                  "MessageKey": "0000000000000000000000070000000300",
                  "OwnerCount": 17,
                  "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
                  "Sequence": 393,
                  "TicketCount": 5,
                  "TransferRate": 4294967295
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
                "PreviousFields": {
                  "Balance": "1086222601"
                },
                "PreviousTxnID": "7E50969CDEF8E12B1AD26E64B338935813624A4D1CDDC4C9457832524F0FF74C",
                "PreviousTxnLgrSeq": 89353048
              }
            },
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rPJARH5nLWQisdmvDAbvzwS7N32Z1kusTZ",
                  "Balance": "55022190",
                  "Flags": 0,
                  "OwnerCount": 0,
                  "Sequence": 89113341
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "C0363F86E070B70E7DA129736C3B05E509261C8668F61A7E958C4C10F17EAB90",
                "PreviousFields": {
                  "Balance": "55022245",
                  "Sequence": 89113340
                },
                "PreviousTxnID": "60D0FE881F9B1457FB1711011C6E490C22532B1D495557D6488BE3A634167CEE",
                "PreviousTxnLgrSeq": 90136515
              }
            }
          ],
          "TransactionIndex": 2,
          "TransactionResult": "tesSUCCESS",
          "delivered_amount": "45"
        },
        "tx_json": {
          "Account": "rPJARH5nLWQisdmvDAbvzwS7N32Z1kusTZ",
          "DeliverMax": "45",
          "Destination": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
          "DestinationTag": 316562,
          "Fee": "10",
          "Sequence": 89113340,
          "SigningPubKey": "EDE21591E615E1D77C8C8A7F95372D001B3DF090AB47B99729CFCBC1E4E07D35F4",
          "TransactionType": "Payment",
          "TxnSignature": "D229FEB6ED82367102AC12DE5045BE6D548CBB52E0CB8F037A23171910A6158FA3377F5118B6CEAFDB07D6D43F76FE29CC26BE1ACBC7A86C9D86E14043C66104",
          "ledger_index": 90136515,
          "date": 777284672
        },
        "ledger_index": 90136515,
        "hash": "894541402AC968C98C329A88D097170B14BF4DEB8B2A7DF377EE89DDD332E018",
        "ledger_hash": "14110F60753176E1F6A71AA084B6AD8663CBB46193CCFCDFAC02561626AA6B75",
        "close_time_iso": "2024-08-18T08:24:32Z",
        "validated": true
      }
      {
        "meta": {
          "AffectedNodes": [
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
                  "AccountTxnID": "932CC7E9BAC1F7B9FA5381679F293EEC0A646E5E7F2F6D14C85FEE2102F0E66C",
                  "Balance": "1086222601",
                  "Domain": "6D64756F31332E636F6D",
                  "EmailHash": "98B4375E1D753E5B91627516F6D70977",
                  "Flags": 9568256,
                  "MessageKey": "0000000000000000000000070000000300",
                  "OwnerCount": 17,
                  "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
                  "Sequence": 393,
                  "TicketCount": 5,
                  "TransferRate": 4294967295
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
                "PreviousFields": {
                  "Balance": "1086222552"
                },
                "PreviousTxnID": "EED9EB1880B951FAB3EE0DBBEB67B7ABEE3FA77F15782B6BD40342B3C23CFB75",
                "PreviousTxnLgrSeq": 89343389
              }
            },
            {
              "ModifiedNode": {
                "FinalFields": {
                  "Account": "rPSDqHdMPsnkmyUX4BvBkY8rycQYwrhUqw",
                  "Balance": "52611432",
                  "Flags": 0,
                  "OwnerCount": 0,
                  "Sequence": 89196186
                },
                "LedgerEntryType": "AccountRoot",
                "LedgerIndex": "20761D2C37004C70318F7A3C5A1C35817A90A0AE56485F6E3281FB2B3F05B0C9",
                "PreviousFields": {
                  "Balance": "52611491",
                  "Sequence": 89196185
                },
                "PreviousTxnID": "BAF86C2776C08407E0FAF42D374874E10430CB8C23AD464D9D9097EA326ABE92",
                "PreviousTxnLgrSeq": 89353024
              }
            }
          ],
          "TransactionIndex": 4,
          "TransactionResult": "tesSUCCESS",
          "delivered_amount": "49"
        },
        "tx_json": {
          "Account": "rPSDqHdMPsnkmyUX4BvBkY8rycQYwrhUqw",
          "DeliverMax": "49",
          "Destination": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
          "DestinationTag": 342662134,
          "Fee": "10",
          "Sequence": 89196185,
          "SigningPubKey": "ED7E4A2970ADFCCE93D59D469322745E98CBEB3D7D5388728B3BB2268E71F30B0F",
          "TransactionType": "Payment",
          "TxnSignature": "8CE14FD18BD186694DED8C204C3FCC2A527CC24AD51C2E0B2B792D035C85D662BC1A1450A8DF04BBEC66821B362056311127C627056AC7779B385517FD3A9202",
          "ledger_index": 89353048,
          "date": 774249571
        },
        "ledger_index": 89353048,
        "hash": "7E50969CDEF8E12B1AD26E64B338935813624A4D1CDDC4C9457832524F0FF74C",
        "ledger_hash": "ED54DA98F3E495C36C2B0D9A511565E04454A1F4503B9DEE3FD39301D7625865",
        "close_time_iso": "2024-07-14T05:19:31Z",
        "validated": true
      }
    ],
    "validated": true,
    "marker": {
      "ledger": 89353048,
      "seq": 4
    },
    "limit": 2
  },
  "api_version": 2,
  "status": "success",
  "type": "response"
}

このレスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれます。

`Field`	型	説明
`account`	文字列	関連するアカウントを識別する一意のアドレス
`ledger_index_min`	数値 - レジャーインデックス	実際に検索された最小のレジャーのレジャーインデックス。
`ledger_index_max`	数値 - レジャーインデックス	実際に検索された最大のレジャーのレジャーインデックス。
`limit`	数値	リクエストで使用された`limit`値。（サーバによって強制される実際の制限値とは異なる場合があります。）
`marker`	マーカー	レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。
`meta`	オブジェクト（JSON）	(JSONモード) トランザクション結果のメタデータのJSON。
`meta_blob`	文字列（バイナリ）	(バイナリモード) トランザクション結果のメタデータの16進文字列。
`transactions`	配列	リクエストの基準を満たすトランザクションの配列。
`validated`	真偽値	このフィールドが含まれていて`true`に設定されている場合、このレスポンス内の情報は検証済みのレジャーバージョンから取得されています。そうでない場合、情報は変更される場合があります。

注記

サーバから返されるledger_index_minおよびledger_index_maxの値がリクエストで指定したものとは異なる場合があります。(例えば、サーバに手元の指定したバージョンがない場合など)

各トランザクションのオブジェクトには以下のフィールドが含まれます。JSONまたはバイナリ（"binary":true）フォーマットのどちらでリクエストされたかによって異なります。

`Field`	型	説明
`close_time_iso`	文字列	ISO 8601形式で表されたレジャー閉鎖時間。
`hash`	文字列	トランザクションの一意のハッシュ識別子。
`ledger_hash`	文字列	このトランザクションを含むレジャーバージョンのハッシュの16進文字列。
`ledger_index`	整数	このトランザクションを含むレジャーバージョンのレジャーインデックス。
`tx_json`	オブジェクト（JSON）	(JSONモード) JSONオブジェクトでトランザクションを定義します。
`tx_blob`	文字列（バイナリ）	(バイナリモード) トランザクションを定義する一意の16進文字列。
`validated`	真偽値	このトランザクションが検証済みのレジャーに含まれるかどうか。検証済みのレジャーに含まれていないトランザクションはすべて、変更される場合があります。

考えられるエラー

いずれかの汎用エラータイプ。
1つ以上のフィールドが正しく指定されていないか、1つ以上の必須フィールドが欠落しています。API v1では、以下のように指定することで、このエラーを回避できます。
- ledger_index_minまたはledger_index_max、またはledger_indexまたはledger_hashを指定します。
- binaryまたはforwardフィールドに対して非ブール値を指定します。
actMalformed - リクエストのaccountフィールドに指定したアドレスが、正しいフォーマットではありません。
lgrIdxMalformed - ledger_index_minまたはledger_index_maxで指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。API v1では、ledger_index_minまたはledger_index_maxにサーバが保有していないレジャーの範囲を指定した場合にこのエラーが発生します。
lgrIdxsInvalid - リクエストでledger_index_minの前にあるledger_index_maxを指定したか、ネットワークと同期されていないためにサーバに検証済みレジャーの範囲が存在しません。