中 / EN打开钱包
Stream / 开发文档
开发文档

account_tx

2022-01-04STREAM / DOCUMENTOR-SECTIONS
此篇内容尚无原站英文对应版本；切换语言后可浏览英文资料库。
该account_tx方法检索涉及指定帐户的交易列表。 请求格式的示例： 
{
  "id": 2,
  "command": "account_tx",
  "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
  "ledger_index_min": -1,
  "ledger_index_max": -1,
  "binary": false,
  "limit": 2,
  "forward": false
}
{
    "method": "account_tx",
    "params": [
        {
            "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
            "binary": false,
            "forward": false,
            "ledger_index_max": -1,
            "ledger_index_min": -1,
            "limit": 2
        }
    ]
}
#Syntax account_tx account ledger_index_min ledger_index_max [offset] [limit] [binary] [count] [forward]
rippled -- account_tx vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV -1 -1 2 5 1 0 1
该请求包含以下参数：
Field 类型 描述
account String 账户的唯一标识符，通常是账户的地址。
ledger_index_min Integer （可选）用于指定最早的分类帐以包含交易。的值-1指示使用可用的最早的验证台账版本的服务器。
ledger_index_max Integer （可选）用于指定最近的分类帐以包含来自的交易。的值-1指示使用可用的最新验证台账版本的服务器。
ledger_hash String （可选）仅用于查找单个分类帐中的交易。（请参阅指定分类帐。）
ledger_index String or Unsigned Integer （可选）仅用于查找单个分类帐中的交易。（请参阅指定分类帐。）
binary Boolean （可选）默认为false。如果设置为true，则将事务作为十六进制字符串而不是JSON返回。
forward Boolean （可选）默认为false。如果设置为true，则首先返回使用最旧的分类帐索引的值。否则，结果将首先与最新的分类帐编入索引。（结果的每页可能不是内部排序的，但页面总体排序。）
limit Integer （可选）默认值有所不同。限制要检索的事务数量。服务器不需要遵守这个值。
marker (Not Specified) 来自之前分页响应的价值。在该响应停止的情况下继续检索数据。即使服务器的可用分类账范围发生变化，该值也是稳定的。
虽然这些领域被标记为可选，则必须使用至少一个在您的要求：ledger_index，ledger_hash，ledger_index_min，或ledger_index_max。
注意：对于WebSocket和JSON-RPC，该account_tx方法还有一个不推荐的旧版本。出于这个原因，Stream建议不使用任何以下字段：offset，count，descending，ledger_max，和ledger_min。如果您使用任何这些已弃用的字段，则该方法不支持分页。
重复查询数据
与其他分页方法一样，您可以使用该marker字段返回多页数据。 在请求之间的时间，"ledger_index_min": -1并且"ledger_index_max": -1可能会更改为指除他们以前做不同的分类帐的版本。marker只要标记未指示请求中指定的分类范围之外的某个点，即使请求中的分类帐范围发生更改，该字段也可以安全分页。 一个成功回应的例子： 
{
  "id": 2,
  "result": {
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "ledger_index_max": 155983,
    "ledger_index_min": 2,
    "limit": 2,
    "marker": {
      "ledger": 153500,
      "seq": 0
    },
    "transactions": [{
      "meta": {
        "AffectedNodes": [{
          "ModifiedNode": {
            "FinalFields": {
              "Account": "vfq4sckDNcNcyfrDQed6FBqqDfEgTgsjtJ",
              "Balance": "21492361",
              "Flags": 8388608,
              "OwnerCount": 14,
              "Sequence": 78
            },
            "LedgerEntryType": "AccountRoot",
            "LedgerIndex": "ADEFE0B5A676E5431444ADA797634C65B963A00B9B79DBFA4821DA786DD6C8B4",
            "PreviousFields": {
              "Balance": "22492373",
              "Sequence": 77
            },
            "PreviousTxnID": "BEE1FD0E440416A4CFD29663ADB2BAB5356CBE3FE2AF7659C69B4153612BBD52",
            "PreviousTxnLgrSeq": 153524
          }
        }, {
          "ModifiedNode": {
            "FinalFields": {
              "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
              "Balance": "99999986730672448",
              "Flags": 0,
              "OwnerCount": 15,
              "Sequence": 293
            },
            "LedgerEntryType": "AccountRoot",
            "LedgerIndex": "C2FA6D77327E553B9D611CA7BE4CC0CB33817EE23919EC09C48D10E4C5653037",
            "PreviousFields": {
              "Balance": "99999986729672448"
            },
            "PreviousTxnID": "BEE1FD0E440416A4CFD29663ADB2BAB5356CBE3FE2AF7659C69B4153612BBD52",
            "PreviousTxnLgrSeq": 153524
          }
        }],
        "TransactionIndex": 0,
        "TransactionResult": "tesSUCCESS",
        "delivered_amount": "1000000"
      },
      "tx": {
        "Account": "vfq4sckDNcNcyfrDQed6FBqqDfEgTgsjtJ",
        "Amount": "1000000",
        "Destination": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
        "Fee": "12",
        "Flags": 2147483648,
        "LastLedgerSequence": 155520,
        "Memos": [{
          "Memo": {
            "MemoData": "68616861",
            "MemoType": "6D656D6F"
          }
        }],
        "Sequence": 77,
        "SigningPubKey": "021ADD58CB32BFD8F3F24A027081CE3928CEE072E85692123DE4DF92EFCF2CE2BC",
        "TransactionType": "Payment",
        "TxnSignature": "304402200C8B73E45DD5C43D6C10ECF26BE1D0212BA121BC0EB090441B09AE21FAD2F17C02206143819F8B15F4C8C83A4735E56E971E7465A76C2116443092E8E7179B4A7AFD",
        "date": 575694990,
        "hash": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
        "inLedger": 155512,
        "ledger_index": 155512
      },
      "validated": true
    }]
  },
  "status": "success",
  "type": "response"
}
200 OK
{
  "result": {
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "ledger_index_max": 155983,
    "ledger_index_min": 2,
    "limit": 2,
    "marker": {
      "ledger": 153500,
      "seq": 0
    },
    "transactions": [{
      "meta": {
        "AffectedNodes": [{
          "ModifiedNode": {
            "FinalFields": {
              "Account": "vfq4sckDNcNcyfrDQed6FBqqDfEgTgsjtJ",
              "Balance": "21492361",
              "Flags": 8388608,
              "OwnerCount": 14,
              "Sequence": 78
            },
            "LedgerEntryType": "AccountRoot",
            "LedgerIndex": "ADEFE0B5A676E5431444ADA797634C65B963A00B9B79DBFA4821DA786DD6C8B4",
            "PreviousFields": {
              "Balance": "22492373",
              "Sequence": 77
            },
            "PreviousTxnID": "BEE1FD0E440416A4CFD29663ADB2BAB5356CBE3FE2AF7659C69B4153612BBD52",
            "PreviousTxnLgrSeq": 153524
          }
        }, {
          "ModifiedNode": {
            "FinalFields": {
              "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
              "Balance": "99999986730672448",
              "Flags": 0,
              "OwnerCount": 15,
              "Sequence": 293
            },
            "LedgerEntryType": "AccountRoot",
            "LedgerIndex": "C2FA6D77327E553B9D611CA7BE4CC0CB33817EE23919EC09C48D10E4C5653037",
            "PreviousFields": {
              "Balance": "99999986729672448"
            },
            "PreviousTxnID": "BEE1FD0E440416A4CFD29663ADB2BAB5356CBE3FE2AF7659C69B4153612BBD52",
            "PreviousTxnLgrSeq": 153524
          }
        }],
        "TransactionIndex": 0,
        "TransactionResult": "tesSUCCESS",
        "delivered_amount": "1000000"
      },
      "tx": {
        "Account": "vfq4sckDNcNcyfrDQed6FBqqDfEgTgsjtJ",
        "Amount": "1000000",
        "Destination": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
        "Fee": "12",
        "Flags": 2147483648,
        "LastLedgerSequence": 155520,
        "Memos": [{
          "Memo": {
            "MemoData": "68616861",
            "MemoType": "6D656D6F"
          }
        }],
        "Sequence": 77,
        "SigningPubKey": "021ADD58CB32BFD8F3F24A027081CE3928CEE072E85692123DE4DF92EFCF2CE2BC",
        "TransactionType": "Payment",
        "TxnSignature": "304402200C8B73E45DD5C43D6C10ECF26BE1D0212BA121BC0EB090441B09AE21FAD2F17C02206143819F8B15F4C8C83A4735E56E971E7465A76C2116443092E8E7179B4A7AFD",
        "date": 575694990,
        "hash": "17CF128117A275D1E0F0638CE38DADD7DE4F978818F1E950C89CA5C62620E27D",
        "inLedger": 155512,
        "ledger_index": 155512
      },
      "validated": true
    }]
  },
  "status": "success",
  "type": "response"
}
响应遵循标准格式，成功结果包含以下字段：
Field 类型 描述
account String 识别相关帐户的唯一地址
ledger_index_min Integer 实际上搜索的最早的分类账序号交易。
ledger_index_max Integer 实际上搜索的最近一次分类账的序列号交易。
limit Integer limit请求中使用的值。（这可能与服务器实际实施的限制值不同。）
marker (Not Specified) 指示响应的服务器定义的值是分页的。将此传递给下一个电话以恢复此通话停止的位置。
transactions Array 如下所述，与请求标准匹配的事务数组。
validated Boolean 如果包含并设置为true，则此回复中的信息来自经过验证的分类帐版本。否则，信息可能会更改。
 
注意：该服务器可能会响应不同于提供ledger_index_min和ledger_index_max的值，例如，如果它没有你手头上指定的版本。
每个事务对象都包含以下字段，具体取决于它是以JSON还是以十六进制字符串（"binary":true）格式请求的。
Field 类型 描述
ledger_index Integer 包含此交易的分类帐版本的序号。
meta Object(JSON)or String(Binary) 如果binary为True，那么这是事务元数据的十六进制字符串。否则，事务元数据将包含在JSON格式中。
tx Object （仅限JSON模式）定义事务的JSON对象
tx_blob String （仅限二进制模式）唯一散列代表事务的字符串。
validated Boolean 交易是否包含在经过验证的分类帐中。任何尚未处于验证分类帐中的交易可能会发生变化。
可能的错误：
  • 任何通用错误类型。
  • invalidParams - 一个或多个字段指定不正确，或缺少一个或多个必填字段。
  • actMalformed- 请求字段中指定的地址account格式不正确。
  • actBitcoin- 该字段中指定的地址account格式化为比特币地址，而不是STM分类帐地址。
  • lgrIdxsInvalid- 由ledger_index_min或者ledger_index_max不存在的分类账，或者存在但服务器不存在。
THE NEXT CONNECTION

下一次连接，从这里开始。

加入 Stream 社区，一起探索价值互联。

联系我们