getAssetTransfers

Get transfers associated with a given asset and/or account in reverse block height order (or in the expected order of execution for expected transfers).

Request: requestType is getAssetTransfers provides expected transfers from the unconfirmed transactions pool or phased transactions scheduled to finish in the next block asset is the asset ID (optional) account is the account ID (optional if asset provided) includeAssetInfo is true if the decimals and name fields are to be included (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 zero-based index to the last transfer to retrieve (optional, does not apply to expected transfers)

Response:

(A) transfers is the array of transfer objects with the following fields for each transfer:

• (S) quantityQNT is the quantity (in QNT) of the asset traded

• (S) senderRS is the Reed-Solomon address of the sender

• (S) assetTransfer is the transaction ID of the asset transfer

• (S) sender is the account ID of the sender

• (S) recipientRS is the Reed-Solomon address of the recipient

• (N) decimals is the number of decimal places used by the asset (if includeAssetInfo is true)

• (S) recipient is the account number of the recipient

• (S) name is the name of the asset (if includeAssetInfo is true)

• (S) asset is the asset ID

• (N) height is the height of the transfer block

• (N) timestamp is the timestamp (in seconds since the genesis block) of the transfer block, does not apply to an expected transfer

(N) requestProcesssingTime is the API request processing time (in millisec)

Example:

Request:

http://localhost:801/BEAM?requestType=getAssetTransfers&asset=3702027329806229573&lastIndex=1

Response:

{ “transfers”: [ { “quantityQNT”: “10000”, “senderRS”: “BEAM-7X92-29W5-7LQA-5EDC7”, “assetTransfer”: “16436527819322024045”, “sender”: “1875121765155055085”, “recipientRS”: “BEAM-7X92-29W5-7LQA-4V8CH”, “decimals”: 2, “recipient”: “9604012506417831413”, “name”: “CryptoMaps”, “asset”: “3702027329806229573”, “height”: 504029, “timestamp”: 121917645 }, { “quantityQNT”: “5500”, “senderRS”: “BEAM-7X92-29W5-7LQA-5EDC7”, “assetTransfer”: “9907383924348587793”, “sender”: “6028278722555736057”, “recipientRS”: “BEAM-7X92-29W5-7LQA-4V8CH”, “decimals”: 2, “recipient”: “4990091736314005379”, “name”: “CryptoMaps”, “asset”: “3702027329806229573”, “height”: 500631, “timestamp”: 121093713 } ], “requestProcessingTime”: 2 }