Skip to main content

transactions

This page describes the structure of the transactions index (Elasticsearch), and also depicts a few examples of how to query it.

_id

The _id field for this index is composed of hex encoded transaction hash. (example: cad4692a092226d68fde24840586bdf36b30e02dc4bf2a73516730867545d53c)

Fields

FieldDescription
miniBlockHashThe miniBlockHash represents the hash of the miniblock in which the transaction was included.
nonceThe nonce field represents the transaction sequence number of the sender address.
roundThe round field represents the round of the block when the transaction was executed.
valueThe value field represents the amount of EGLD to be sent from the sender to the receiver.
receiverThe receiver field represents the destination address of the transaction.
senderThe sender field represents the address of the transaction sender.
receiverShardThe receiverShard field represents the shard ID of the receiver address.
senderShardThe senderShard field represents the shard ID of the sender address.
gasPriceThe gasPrice field represents the amount to be paid for each gas unit.
gasLimitThe gasLimit field represents the maximum gas units the sender is willing to pay for.
gasUsedThe gasUsed field represents the amount of gas used by the transaction.
feeThe fee field represents the amount of EGLD the sender paid for the transaction.
initialPaidFeeThe initialPaidFee field represents the initial amount of EGLD the sender paid for the transaction, before the refund.
dataThe data field holds additional information for a transaction. It can contain a simple message, a function call, an ESDT transfer payload, or so on.
signatureThe signature obtained by the sender after signing the transaction. It is hex-encoded.
timestampThe timestamp field represents the timestamp of the block in which the transaction was executed.
statusThe status field represents the status of the transaction.
senderUserNameThe senderUserName field represents the username of the sender address.
receiverUserNameThe receiverUserName field represents the username of the receiver address.
hasScResultsThe hasScResults field is true if the transaction has smart contract results.
isScCallThe isScCall field is true if the transaction is a smart contract call.
hasOperationsThe hasOperations field is true if the transaction has smart contract results or logs.
tokensThe tokens field contains a list of ESDT tokens that are transferred based on the data field. The indices from the tokens list are linked with the indices from esdtValues list.
esdtValuesThe esdtValues field contains a list of ESDT values that are transferred based on the data field.
receiversThe receivers field contains a list of receiver addresses in case of ESDTNFTTransfer or MultiESDTTransfer.
receiversShardIDsThe receiversShardIDs field contains a list of receiver addresses shard IDs.
typeThe type field represents the type of the transaction based on the data field.
operationThe operation field represents the operation of the transaction based on the data field.
functionThe function field holds the name of the function that is called in case of a smart contract call.
isRelayedThe isRelayed field is true if the transaction is a relayed transaction.
versionThe version field represents the version of the transaction.

Query examples

Fetch the latest transactions of an address

curl --request GET \
--url ${ES_URL}/transactions/_search \
--header 'Content-Type: application/json' \
--data '{
"query": {
"bool": {
"should": [
{
"match": {
"sender": "erd..."
}
},
{
"match": {
"receiver": "erd..."
}
},
{
"match": {
"receivers": "erd..."
}
}
]
}
},
"sort": [
{
"timestamp": {
"order": "desc"
}
}
]
}'