Skip to main content

/tokens/:identifier:/transfers

Returns both transfers triggerred by a user account, as well as transfers triggerred by smart contracts, thus providing a full picture of all in/out value transfers for a given account​

Parameters​

  • identifier REQUIRED(string) - Search by token identifier
  • 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
  • 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 forma
  • 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)

Example​

Request

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/tokens/ASTRO-91f2cc/transfers?miniBlockHash=f014daeed74a594918e84d3a3f6bd5d31c5d07a25350435bb7d27a5c0d8cf569&status=success&order=asc' \
  -H 'accept: application/json'

Result

[
  {
    "txHash": "af01a1695a8dfebb3a419a537d6ce7b8b3a69fc2113475c69eca0ebe0ccf8a7a",
    "gasLimit": 500000,
    "gasPrice": 1000000000,
    "gasUsed": 334000,
    "miniBlockHash": "f014daeed74a594918e84d3a3f6bd5d31c5d07a25350435bb7d27a5c0d8cf569",
    "nonce": 1,
    "receiver": "erd13dudsfrnypmz8dqwyu8e25dgcayzhv0hghn7a5a4llmgudaf0jkqlyd9ac",
    "receiverShard": 0,
    "round": 7959341,
    "sender": "erd1m83yu75aw6r0vmznpet78jsguww3fuqll0k2rz64saf8e6p3e24s3zrap2",
    "senderShard": 1,
    "signature": "8a40c45018f3a9365675c699877bf56f11e8c5e034620f5cda71dd94814873f4c79aec3d62f0f1c69520237ad86a55f2877580a24d54085a46654524cc42ff08",
    "status": "success",
    "value": "0",
    "fee": "136000000000000",
    "timestamp": 1643873646,
    "data": "RVNEVFRyYW5zZmVyQDQxNTM1NDUyNGYyZDM5MzE2NjMyNjM2M0AwNTZiYzc1ZTJkNjMxMDAwMDA=",
    "action": {
      "category": "esdtNft",
      "name": "transfer",
      "description": "Transfer",
      "arguments": {
        "transfers": [
          {
            "type": "FungibleESDT",
            "name": "AstroElrond",
            "ticker": "ASTRO-91f2cc",
            "token": "ASTRO-91f2cc",
            "decimals": 18,
            "value": "100000000000000000000"
          }
        ],
        "receiver": "erd13dudsfrnypmz8dqwyu8e25dgcayzhv0hghn7a5a4llmgudaf0jkqlyd9ac"
      }
    },
    "type": "Transaction"
  }
]