Get Currency Transfers

Get currency transfers given a currency ID and/or an account ID in reverse block height order (or in expected order of execution for expected transfers).

Request:

• requestType is either getCurrencyTransfers or getExpectedCurrencyTransfers, where expected transfers are from the unconfirmed transactions pool or are phased transactions scheduled to finish in the next block
• currency is the currency ID (optional)
• account is the account ID (optional if currency provided)
• timestamp is the earliest transfer (in seconds since the genesis block) to retrieve (optional, does not apply to expected transfers)
• firstIndex is a zero-based index to the first transfer to retrieve (optional, does not apply to expected transfers)
• lastIndex is a zero-based index to the last transfer to retrieve (optional, does not apply to expected transfers)
• includeCurrencyInfo is true to include some currency fields (optional, does not apply to expected transfers)
• requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)
• requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

• transfers (A) is an array of transfer objects with the following fields for each transfer:
  • code (S) is the currency code
  • units (S) is the amount (in QNT) of the transfer
  • issuanceHeight (N) is the blockchain height of the currency issuance for a reservable currency
  • type (N) is the currency type bitmask
  • issuerAccountRS (S) is the Reed-Solomon address of the issuer account
  • transfer (S) is the transfer ID
  • senderRS (S) is the Reed-Solomon address of the sender account
  • sender (S) is the account number of the sender account
  • recipientRS (S) is the Reed-Solomon address of the recipient account
  • decimals (N) is the number of decimal places used by the currency
  • recipient (S) is the account number of the recipient account
  • name (S) is the currency name
  • currency (S) is the currency ID
  • issuerAccount (S) is the issuer account ID
  • height (N) is the blockchain height of the transfer
  • timestamp (N) is the timestamp (in seconds since the genesis block) of the transfer block, does not apply to an expected transfer
  • phased (B) is true if the transaction is phased, false otherwise, applies only to an expected transfer
  • issuerAccountRS (S) is the Reed-Solomon address of the issuer account
  • issuerAccount (S) is the issuer account ID
• lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)
• requestProcessingTime (N) is the API request processing time (in millisec)