Skip to main content

/accounts/:address:/transfers

Returns both transfers triggerred by a user account (type = Transaction), as well as transfers triggerred by smart contracts (type = SmartContractResult), thus providing a full picture of all in/out value transfers for a given account

Parameters​

  • address REQUIRED (string) - Account bech32 address
  • from OPTIONAL (string) - Number of items to skip for the result set
  • sizeOPTIONAL (string) - Number of items to retrieve
  • sender OPTIONAL : (string) - Address of the transaction sender
  • receiver OPTIONAL : (string) - Address of the transaction receiver
  • token OPTIONAL : (string) - Identifier of the token
  • senderShard OPTIONAL : (number) - Id of the shard the sender address belongs to
  • receiverShard OPTIONAL : (number) - Id of the shard the receiver address belongs to
  • miniBlockHash OPTIONAL : (string) - Filter by miniblock hash
  • hashes OPTIONAL : (array[string]) - Filter by a comma-separated list of transaction hashes
  • status OPTIONAL : (string) - Status of the transaction (success / pending / invalid / fail)
  • search OPTIONAL : (string) - Search in data object
  • before OPTIONAL : (number) - Before timestamp
  • after OPTIONAL : (number) - After timestamp
  • order OPTIONAL : (string) - Sort order (asc/desc)

Returns​

  • txHash : (string) - The hash of the transaction
  • gasLimit : (number) - The maximum number of gas units allocated for the transaction
  • gasPrice : (number) - The gas price to be used in the scope of the transaction
  • gasUsed : (number) - Is the consumed amount from the provided gas limit - the amount of gas units actually required by the Network in order to process the transaction
  • miniBlockHash : (string) - Contains all transactions that have either the sender in the current shard and the receiver in another shard or the sender in a different shard and the destination in the current shard
  • nonce: (number) - The account sequence number
  • receiver: (string) - The address of the receiver (bech32 format)
  • receiverAssets: (object)
  • receiverShard : (number) - The shard ID allocated to the receiver
  • round: (number) - fixed time duration, consistent across the network, currently decided to be 5 seconds
  • sender : (string) - The address of the sender (bech32 format)
  • senderAssets : (object)
  • senderShard : (number) - The shard ID allocated to the sender
  • signature : (string)- The Signature (hex-encoded) of the Transaction
  • status : (string) - Transaction status (success or executed, invalid, pending, partially-executed, received, failed)
  • value : (string) - The Value to transfer, as a string representation of a Big Integer (can be "0"), EGLD times denomination
  • fee : (string) - Measured in EGLD, is computed with respect to the actual gas cost - broken down into its components - and the gas price per gas unit, which differs between the components
  • timestamp : (number) - u64 format
  • data : (string) - Arbitrary information about the transaction, base64-encoded
  • function: (string)
  • action: (object)
    • category: (string)
    • name : (string)
    • description: (string)
    • arguments: (object)
  • scamInfo: (object)
    • type: (string)
    • info: (sgtring)
  • type : (string)
  • originalTxHash : (string)
  • pendingResults : (boolean)

Example​

Request

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/accounts/erd1kzqsz927u9smz4y7wqc7v3cc5w6n7m0zcveg59twt6y44x00wn6sun45pa/transfers?from=2&size=1&sender=erd1kzqsz927u9smz4y7wqc7v3cc5w6n7m0zcveg59twt6y44x00wn6sun45pa&receiver=erd1kzqsz927u9smz4y7wqc7v3cc5w6n7m0zcveg59twt6y44x00wn6sun45pa&status=success' \
  -H 'accept: application/json'

Result

[
  {
    "txHash": "0e91366fab30000fa622a3c5cdee6723e7b1158583c8732beced5b832475f8c8",
    "gasLimit": 30000000,
    "gasPrice": 1000000000,
    "gasUsed": 16540058,
    "miniBlockHash": "b7837e95b85eda28c6de0758c33cbb3d0d1a1af9f1f2bc1db24de2be016689b2",
    "nonce": 755,
    "receiver": "erd1kzqsz927u9smz4y7wqc7v3cc5w6n7m0zcveg59twt6y44x00wn6sun45pa",
    "receiverShard": 1,
    "round": 10438953,
    "sender": "erd1kzqsz927u9smz4y7wqc7v3cc5w6n7m0zcveg59twt6y44x00wn6sun45pa",
    "senderShard": 1,
    "signature": "a2105bc88aa5ef1be5be85518614892b8a9aa1d975425d51556bb7db6f082de530b456b3429f610dfa9b62a540f561c6e06d9d905b01d474da5f46551c1de806",
    "status": "success",
    "value": "0",
    "fee": "430225580000000",
    "timestamp": 1658751318,
    "data": "RVNEVE5GVFRyYW5zZmVyQDRjNGI1NTUwNDE1MjRiMmQzMzM0NjMzODY1NjFAMDFAMGJhNDNiNzQwMEAwMDAwMDAwMDAwMDAwMDAwMDUwMDAwN2U4ZTZmYjc5MzVhMGNmYWRjOTA2MDE1OWFmOGFhNjVhYjYyOTlmYmEzQDczNzQ2MTZiNjU0NjYxNzI2ZEAwMQ==",
    "function": "stakeFarm",
    "action": {
      "category": "esdtNft",
      "name": "transfer",
      "description": "Transfer",
      "arguments": {
        "transfers": [
          {
            "type": "MetaESDT",
            "name": "LockedUPARK",
            "ticker": "LKUPARK",
            "svgUrl": "https://media.elrond.com/tokens/asset/LKUPARK-34c8ea/logo.svg",
            "collection": "LKUPARK-34c8ea",
            "decimals": 6,
            "identifier": "LKUPARK-34c8ea-01",
            "value": "50000000000"
          }
        ],
        "receiver": "erd1qqqqqqqqqqqqqpgqqplgumahjddqe7kujpsptxhc4fj6kc5elw3sa7grju",
        "functionName": "stakeFarm",
        "functionArgs": [
          "01"
        ]
      }
    },
    "type": "Transaction"
  }
]