Skip to main content

/api/v3/transactions RPC Method

Get transactions by specified filter.

Updated on
Nov 27, 2025

Query Parameters

workchain
integer

Block workchain

shard
string

Block shard id. Must be sent with workchain. Example: 8000000000000000

seqno
integer

Block block seqno. Must be sent with workchain and shard

mc_seqno
integer

Masterchain block seqno

account
array

List of account addresses to get transactions. Can be sent in hex, base64 or base64url form

exclude_account
array

Exclude transactions on specified account addresses

hash
string

Transaction hash

lt
integer

Transaction lt

start_utime
integer

Query transactions with generation UTC timestamp after given timestamp

end_utime
integer

Query transactions with generation UTC timestamp before given timestamp

start_lt
integer

Query transactions with lt >= start_lt

end_lt
integer

Query transactions with lt <= end_lt

limit
integer

Limit number of queried rows. Use with offset to batch read

offset
integer

Skip first N rows. Use with limit to batch read

sort
string

Sort transactions by lt

Returns

transactions
array

Transactions of the transaction

account
string | null

Account of the transaction

account_state_after
object

(Optional) The state of the account after the transaction has been applied

account_status
string | null

The status of the account after the transaction (e.g., active, uninitialized, frozen)

balance
string | null

The account's balance after the transaction, in nanotons

code_boc
string | null

The BOC-encoded smart contract code associated with the account after the transaction

code_hash
string | null

The hash of the smart contract code after the transaction

data_boc
string | null

The BOC-encoded persistent storage data of the account after the transaction

data_hash
string | null

The hash of the contract's data section after the transaction

extra_currencies
object | null

(Optional) The map of additional currencies held by the account, if any

<dynamic_key>
string

The amount held for each currency identifier

frozen_hash
string | null

The hash of the frozen account state, if the account is frozen

hash
string | null

The overall hash of the account state after the transaction

account_state_before
object

(Optional) The state of the account before the transaction was executed

account_status
string | null

The status of the account before the transaction (e.g., active, uninitialized, frozen)

balance
string | null

The account balance before the transaction, in nanotons

code_boc
string | null

The BOC-encoded smart contract code before the transaction

code_hash
string | null

The hash of the contract code before the transaction

data_boc
string | null

The BOC-encoded persistent storage data before the transaction

data_hash
string | null

The hash of the contract's data section before the transaction

extra_currencies
object | null

(Optional) The additional currencies held by the account before the transaction

<dynamic_key>
string

The amount held for each currency identifier

frozen_hash
string | null

The hash of the frozen account state, if the account was frozen

hash
string | null

The overall hash of the account state before the transaction

block_ref
object

(Optional) The reference to the block in which the transaction was included

seqno
integer | null

The sequence number of the block

shard
string | null

The shard identifier of the block

workchain
integer | null

The workchain ID of the block

description
object

The detailed breakdown of the transaction execution

aborted
boolean

The flag indicating if the transaction was aborted

action
object

(Optional) The action phase data of the transaction

action_list_hash
string | null

The hash of the action list

msgs_created
integer | null

The number of messages created in the action phase

no_funds
boolean

The flag indicating if the transaction had insufficient funds

result_arg
integer | null

The result argument returned from the action phase

result_code
integer | null

The result code returned from the action phase

skipped_actions
integer | null

The number of skipped actions during execution

spec_actions
integer | null

The number of special actions executed

status_change
string | null

The status change applied to the account during the action phase

success
boolean

The flag indicating whether the action phase succeeded

tot_actions
integer | null

The total number of actions processed

tot_msg_size
object

(Optional) The total size of messages created in the action phase

bits
string | null

The total number of bits used

cells
string | null

The total number of cells used

total_action_fees
string | null

The total fees charged for actions

total_fwd_fees
string | null

The total forwarding fees charged

valid
boolean

The flag indicating whether the action phase was valid

bounce
object

(Optional) The bounce phase data of the transaction

fwd_fees
string | null

The forwarding fees paid in the bounce phase

msg_fees
string | null

The message fees charged in the bounce phase

msg_size
object

(Optional) The size of the bounced message

bits
string | null

The number of bits in the message

cells
string | null

The number of cells in the message

req_fwd_fees
string | null

The required forwarding fees for the bounce message

type
string | null

The bounce message type

compute_ph
object

The compute phase data of the transaction

account_activated
boolean

The flag indicating if the account was activated during compute

exit_arg
integer | null

The exit argument returned from the VM

exit_code
integer | null

The exit code returned from the VM

gas_credit
string | null

The gas credit used in the compute phase

gas_fees
string | null

The gas fees charged for compute

gas_limit
string | null

The gas limit for the compute phase

gas_used
string | null

The total gas used in the compute phase

mode
integer | null

The compute execution mode

msg_state_used
boolean

The flag indicating if message state was used

reason
string | null

The reason string returned from the compute phase, if any

skipped
boolean

The flag indicating if the compute phase was skipped

success
boolean

The success state of the compute phase

vm_final_state_hash
string | null

The hash of the final VM state after compute

vm_init_state_hash
string | null

The hash of the initial VM state before compute

vm_steps
integer | null

The number of steps executed by the VM

credit_first
boolean

The flag indicating if credit was applied before compute

credit_ph
object

(Optional) The credit phase of the transaction

credit
string | null

The credited amount

credit_extra_currencies
object

(Optional) The additional currencies credited to the account

<dynamic_key>
string

The amount held for each currency identifier

due_fees_collected
string | null

The fees collected during the credit phase

destroyed
boolean

The flag indicating if the account was destroyed

installed
boolean

The flag indicating if the contract was installed

is_tock
boolean

The flag indicating if this was a tock transaction

split_info
object

(Optional) The information about shard split performed during the transaction

acc_split_depth
integer | null

The account split depth value

cur_shard_pfx_len
integer | null

The current shard prefix length

sibling_addr
string | null

The address of the sibling shard

this_addr
string | null

The address of the current shard

storage_ph
object

The storage phase data of the transaction

status_change
string | null

The status change in the storage phase

storage_fees_collected
string | null

The storage fees collected during this phase

storage_fees_due
string | null

The storage fees due but not yet collected

type
string | null

The transaction type (e.g., tick-tock, ord, split-prepare)

emulated
boolean

Emulated state of the transaction

end_status
string | null

End status of the transaction

hash
string | null

Hash of the transaction

in_msg
object | null

(Optional) The incoming message associated with the transaction

bounce
boolean | null

The flag indicating if the message requested a bounce on failure

bounced
boolean | null

The flag indicating if the message was bounced back

created_at
string | null

The timestamp when the message was created

created_lt
string | null

The logical time when the message was created

destination
string | null

The address to which the message was sent

fwd_fee
string | null

The forwarding fee for the message

hash
string | null

The base64-encoded hash of the message

hash_norm
string | null

The normalized version of the message hash

ihr_disabled
boolean | null

The flag indicating if IHR (Instant Hypercube Routing) is disabled

ihr_fee
string | null

The fee for IHR delivery

import_fee
string | null

The fee for importing the message

in_msg_tx_hash
string | null

The hash of the transaction that produced this incoming message

init_state
object | null

(Optional) The initial state of the contract, if provided by the message

body
string | null

The body of the initial state in BOC format

decoded
object | null

(Optional) The decoded metadata from the initial state body

comment
string | null

(Optional) The optional human-readable comment in the initial state

type
string | null

(Optional) The type of payload decoded from the initial state

@type
string | null

(Optional) TL-B type identifier for the decoded payload

query_id
string | null

(Optional) Query identifier from the decoded payload

amount
object | null

(Optional) Amount value from the decoded payload

from
object | null

(Optional) Source address object from the decoded payload

response_address
object | null

(Optional) Response address object from the decoded payload

forward_ton_amount
object | null

(Optional) Forwarded TON amount from the decoded payload

forward_payload
object | null

(Optional) Forwarded payload from the decoded payload

sender
object | null

(Optional) Sender address object from the decoded payload

<dynamic_key>
JSON

Additional TL-B decoded fields for specialized message types

hash
string | null

The hash of the initial state

message_content
object

The content body of the message

body
string | null

The raw message body in BOC format

decoded
object | null

(Optional) The decoded content of the message

comment
string | null

(Optional) The human-readable comment in the message

type
string | null

(Optional) The type of decoded content

@type
string | null

(Optional) TL-B type identifier for the decoded payload

query_id
string | null

(Optional) Query identifier from the decoded payload

amount
object | null

(Optional) Amount value from the decoded payload

from
object | null

(Optional) Source address object from the decoded payload

response_address
object | null

(Optional) Response address object from the decoded payload

forward_ton_amount
object | null

(Optional) Forwarded TON amount from the decoded payload

forward_payload
object | null

(Optional) Forwarded payload from the decoded payload

sender
object | null

(Optional) Sender address object from the decoded payload

<dynamic_key>
JSON

Additional TL-B decoded fields for specialized message types

hash
string | null

The hash of the message content

opcode
string | null

The opcode included in the message payload (hex string or null)

out_msg_tx_hash
string | null

The hash of the transaction that emitted this as an outgoing message

source
string | null

The source address that sent the message

value
string | null

The amount of nanotons transferred with the message

value_extra_currencies
object | null

(Optional) The map of any additional currencies included in the message

<dynamic_key>
string

The amount held for each extra currency ID

extra_flags
string | null

Extra flags encoded as a hexadecimal string

decoded_opcode
string | null

Decoded opcode from the message body, if available

lt
string | null

The logical time of the transaction

mc_block_seqno
integer | null

Masterchain block sequence number

now
integer | null

Current time of the transaction

orig_status
string | null

Original status of the transaction

out_msgs
array

The list of outgoing messages produced by the transaction

bounce
boolean | null

The flag indicating if the message requested a bounce on failure

bounced
boolean | null

The flag indicating if the message was bounced back

created_at
string | null

The timestamp when the message was created

created_lt
string | null

The logical time when the message was created

destination
string | null

The address to which the message was sent

fwd_fee
string | null

The forwarding fee for the message

hash
string | null

The base64-encoded hash of the message

hash_norm
string | null

The normalized version of the message hash

ihr_disabled
boolean | null

The flag indicating if IHR (Instant Hypercube Routing) is disabled

ihr_fee
string | null

The fee for IHR delivery

import_fee
string | null

The fee for importing the message

in_msg_tx_hash
string | null

The hash of the transaction that produced this incoming message

init_state
object | null

(Optional) The initial state of the contract, if provided by the message

body
string | null

The body of the initial state in BOC format

decoded
object | null

(Optional) The decoded metadata from the initial state body

comment
string | null

(Optional) The optional human-readable comment in the initial state

type
string | null

(Optional) The type of payload decoded from the initial state

@type
string | null

(Optional) TL-B type identifier for the decoded payload

query_id
string | null

(Optional) Query identifier from the decoded payload

amount
object | null

(Optional) Amount value from the decoded payload

from
object | null

(Optional) Source address object from the decoded payload

response_address
object | null

(Optional) Response address object from the decoded payload

forward_ton_amount
object | null

(Optional) Forwarded TON amount from the decoded payload

forward_payload
object | null

(Optional) Forwarded payload from the decoded payload

sender
object | null

(Optional) Sender address object from the decoded payload

<dynamic_key>
JSON

Additional TL-B decoded fields for specialized message types

hash
string | null

The hash of the initial state

message_content
object

The content body of the message

body
string | null

The raw message body in BOC format

decoded
object | null

(Optional) The decoded content of the message

comment
string | null

(Optional) The human-readable comment in the message

type
string | null

(Optional) The type of decoded content

@type
string | null

(Optional) TL-B type identifier for the decoded payload

query_id
string | null

(Optional) Query identifier from the decoded payload

amount
object | null

(Optional) Amount value from the decoded payload

from
object | null

(Optional) Source address object from the decoded payload

response_address
object | null

(Optional) Response address object from the decoded payload

forward_ton_amount
object | null

(Optional) Forwarded TON amount from the decoded payload

forward_payload
object | null

(Optional) Forwarded payload from the decoded payload

sender
object | null

(Optional) Sender address object from the decoded payload

<dynamic_key>
JSON

Additional TL-B decoded fields for specialized message types

hash
string | null

The hash of the message content

opcode
string | null

The opcode included in the message payload (hex string or null)

out_msg_tx_hash
string | null

The hash of the transaction that emitted this as an outgoing message

source
string | null

The source address that sent the message

value
string | null

The amount of nanotons transferred with the message

value_extra_currencies
object | null

(Optional) The map of any additional currencies included in the message

<dynamic_key>
string

The amount held for each extra currency ID

extra_flags
string | null

Extra flags encoded as a hexadecimal string

decoded_opcode
string | null

Decoded opcode from the message body, if available

prev_trans_hash
string | null

Previous transaction hash

prev_trans_lt
string | null

Previous transaction logical time

total_fees
string | null

Total fees of the transaction

total_fees_extra_currencies
object | null

(Optional) Extra currencies in the total fees

<dynamic_key>
string

Each key maps to a value of type string

trace_external_hash
string | null

External hash of the trace

trace_id
string | null

ID of the trace

finality
string

Finality status of the transaction

address_book
object

(Optional) Address book of the transaction

<dynamic_key>
object

Each key maps to a AddressBookRow object

domain
string | null

Domain of the address book

user_friendly
string | null

User friendly name of the address book

interfaces
array | null

(Optional) Detected contract interfaces for the address

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