Skip to main content

/v1/transactions REST API Endpoint

Retrieves a list of committed transactions from the Aptos blockchain network. It supports pagination by specifying the page size and start ledger version to obtain a specific sequence of transactions.

Updated on
Oct 04, 2023

Query Parameters

limit
integer

The maximum number of resources to retrieve per transaction

start
string

The starting point or offset for retrieving transactions

Returns

array
array

An array of committed transactions

version
string

Ledger version of the committed transaction

hash
string

The hash of the transaction

state_change_hash
string

Hash of the state changes produced by the transaction

event_root_hash
string

Hash of the event accumulator root for the transaction

state_checkpoint_hash
string | null

Hash of the state checkpoint encoded in hex; null for some user transactions

gas_used
string

Gas consumed executing the transaction

success
boolean

Whether the transaction executed successfully

vm_status
string

VM execution status message

accumulator_root_hash
string

Hash of the transaction accumulator root

changes
array

State changes applied by the transaction

type
string

Change kind (e.g. write_resource, write_table_item)

state_key_hash
string

Hash of the state key affected by this change

address
string

(Optional) Account address for write_resource changes

handle
string

(Optional) Table handle for write_table_item changes

key
string

(Optional) Encoded table key for write_table_item changes

value
string

(Optional) Encoded table value for write_table_item changes

data
object | null

(Optional) Resource data for write_resource changes; null for some write_table_item entries

timestamp
string

Transaction timestamp in microseconds

block_end_info
object

(Optional) Block epilogue metadata; present on block_epilogue_transaction entries

block_gas_limit_reached
boolean

Whether the block hit the gas limit

block_output_limit_reached
boolean

Whether the block hit the output size limit

block_effective_block_gas_units
integer

Effective gas units used in the block

block_approx_output_size
integer

Approximate serialized output size for the block

type
string

Transaction type (e.g. user_transaction, block_epilogue_transaction)

events
array

(Optional) Events emitted by user transactions

guid
object

Event GUID

sequence_number
string

Sequence number of the event

type
string

Fully qualified event type

data
object

Event payload

replay_protection_nonce
string | null

(Optional) Replay-protection nonce on user transactions, or null when not used

txn_limits_request
object | null

(Optional) Transaction limits request metadata when present

sender
string

(Optional) The account from which the transaction was sent

sequence_number
string

(Optional) The sequence of a transaction sent by the specific sender

max_gas_amount
string

(Optional) The maximum amount of gas allocated for the execution of a transaction

gas_unit_price
string

(Optional) The cost per unit of gas, determining the transaction fee paid by the sender for each unit of computational resource consumed

expiration_timestamp_secs
string

(Optional) The timestamp indicating the expiration period of a transaction, specifying the time until which the transaction can be included in a block

payload
object

(Optional) The data that is being carried by a transaction. It contains the following fields:

type
string

The type of payload indicating the purpose of the data contained

function
string

The function associated with the payload

type_arguments
array

An array specifying the types of arguments provided to the function

arguments
array

An array containing the actual arguments passed to the function

signature
object

(Optional) An array with the following fields:

type
string

The type of signature used to verify the authenticity of the function

public_key
string

The public key associated with the account that generated the signature, used for verifying the signature's validity

signature
string

The actual signature generated using the private key corresponding to the public key provided

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free