Skip to main content

/api/v3/transactionsByMessage RPC Method

Get transactions whose inbound/outbound message has the specified hash.

Updated on
Nov 27, 2025

Query Parameters

msg_hash
string

Message hash. Acceptable in hex, base64 and base64url forms.

body_hash
string

Hash of message body.

opcode
string

Opcode of message in hex or signed 32-bit decimal form.

direction
string

Direction of message.

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.

Returns

TransactionsResponse
object

Response object containing transaction information and related address data

address_book
object

Mapping of addresses to their human-readable information

<dynamic_key>
object

Each key maps to a AddressBookRow object containing address metadata

domain
string

Domain name associated with the address

user_friendly
string

Human-readable representation of the address

transactions
array

Transactions of the transaction

account
string

Account of the transaction

account_state_after
object

The state of the account after the transaction has been applied

account_status
string

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

balance
string

The account's balance after the transaction, in nanotons

code_boc
string

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

code_hash
string

The hash of the smart contract code after the transaction

data_boc
string

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

data_hash
string

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

extra_currencies
object

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

<dynamic_key>
string

The amount held for each currency identifier

frozen_hash
string

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

hash
string

The overall hash of the account state after the transaction

account_state_before
object

The state of the account before the transaction was executed

account_status
string

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

balance
string

The account balance before the transaction, in nanotons

code_boc
string

The BOC-encoded smart contract code before the transaction

code_hash
string

The hash of the contract code before the transaction

data_boc
string

The BOC-encoded persistent storage data before the transaction

data_hash
string

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

extra_currencies
object

The additional currencies held by the account before the transaction

<dynamic_key>
string

The amount held for each currency identifier

frozen_hash
string

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

hash
string

The overall hash of the account state before the transaction

block_ref
object

The reference to the block in which the transaction was included

seqno
integer

The sequence number of the block

shard
string

The shard identifier of the block

workchain
integer

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

The action phase data of the transaction

action_list_hash
string

The hash of the action list

msgs_created
integer

The number of messages created in the action phase

no_funds
boolean

The flag indicating if the transaction had insufficient funds

result_arg
integer

The result argument returned from the action phase

result_code
integer

The result code returned from the action phase

skipped_actions
integer

The number of skipped actions during execution

spec_actions
integer

The number of special actions executed

status_change
string

The status change applied to the account during the action phase

success
boolean

The flag indicating whether the action phase succeeded

tot_actions
integer

The total number of actions processed

tot_msg_size
object

The total size of messages created in the action phase

bits
string

The total number of bits used

cells
string

The total number of cells used

total_action_fees
string

The total fees charged for actions

total_fwd_fees
string

The total forwarding fees charged

valid
boolean

The flag indicating whether the action phase was valid

bounce
object

The bounce phase data of the transaction

fwd_fees
string

The forwarding fees paid in the bounce phase

msg_fees
string

The message fees charged in the bounce phase

msg_size
object

The size of the bounced message

bits
string

The number of bits in the message

cells
string

The number of cells in the message

req_fwd_fees
string

The required forwarding fees for the bounce message

type
string

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

The exit argument returned from the VM

exit_code
integer

The exit code returned from the VM

gas_credit
string

The gas credit used in the compute phase

gas_fees
string

The gas fees charged for compute

gas_limit
string

The gas limit for the compute phase

gas_used
string

The total gas used in the compute phase

mode
integer

The compute execution mode

msg_state_used
boolean

The flag indicating if message state was used

reason
string

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

The hash of the final VM state after compute

vm_init_state_hash
string

The hash of the initial VM state before compute

vm_steps
integer

The number of steps executed by the VM

credit_first
boolean

The flag indicating if credit was applied before compute

credit_ph
object

The credit phase of the transaction

credit
string

The credited amount

credit_extra_currencies
object

The additional currencies credited to the account

<dynamic_key>
string

The amount held for each currency identifier

due_fees_collected
string

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

The information about shard split performed during the transaction

acc_split_depth
integer

The account split depth value

cur_shard_pfx_len
integer

The current shard prefix length

sibling_addr
string

The address of the sibling shard

this_addr
string

The address of the current shard

storage_ph
object

The storage phase data of the transaction

status_change
string

The status change in the storage phase

storage_fees_collected
string

The storage fees collected during this phase

storage_fees_due
string

The storage fees due but not yet collected

type
string

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

emulated
boolean

Emulated state of the transaction

end_status
string

End status of the transaction

hash
string

Hash of the transaction

in_msg
object

The incoming message associated with the transaction

bounce
boolean

The flag indicating if the message requested a bounce on failure

bounced
boolean

The flag indicating if the message was bounced back

created_at
string

The timestamp when the message was created

created_lt
string

The logical time when the message was created

destination
string

The address to which the message was sent

fwd_fee
string

The forwarding fee for the message

hash
string

The base64-encoded hash of the message

hash_norm
string

The normalized version of the message hash

ihr_disabled
boolean

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

ihr_fee
string

The fee for IHR delivery

import_fee
string

The fee for importing the message

in_msg_tx_hash
string

The hash of the transaction that produced this incoming message

init_state
object

The initial state of the contract, if provided by the message

body
string

The body of the initial state in BOC format

decoded
object

The decoded metadata from the initial state body

comment
string

The optional human-readable comment in the initial state

type
string

The type of payload decoded from the initial state

hash
string

The hash of the initial state

message_content
object

The content body of the message

body
string

The raw message body in BOC format

decoded
object

The decoded content of the message

comment
string

The human-readable comment in the message

type
string

The type of decoded content

hash
string

The hash of the message content

opcode
integer

The opcode included in the message payload

out_msg_tx_hash
string

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

source
string

The source address that sent the message

value
string

The amount of nanotons transferred with the message

value_extra_currencies
object

The map of any additional currencies included in the message

<dynamic_key>
string

The amount held for each extra currency ID

lt
string

The logical time of the transaction

mc_block_seqno
integer

Masterchain block sequence number

now
integer

Current time of the transaction

orig_status
string

Original status of the transaction

out_msgs
array

The list of outgoing messages produced by the transaction

bounce
boolean

The flag indicating if the message is set to bounce on failure

bounced
boolean

The flag indicating if the message was bounced back

created_at
string

The timestamp when the message was created

created_lt
string

The logical time when the message was created

destination
string

The address to which the message was sent

fwd_fee
string

The forwarding fee paid for this message

hash
string

The base64-encoded hash of the message

hash_norm
string

The normalized version of the message hash

ihr_disabled
boolean

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

ihr_fee
string

The fee charged for IHR delivery

import_fee
string

The fee paid for importing the message

in_msg_tx_hash
string

The transaction hash that originated this message

init_state
object

The initial state of the contract sent with the message

body
string

The BOC-encoded body of the initial state

decoded
object

The decoded data from the initial state

comment
string

The optional comment from the initial state

type
string

The type of decoded content in the initial state

hash
string

The hash of the initial state

message_content
object

The decoded and raw body of the message

body
string

The raw BOC-encoded body of the message

decoded
object

The decoded metadata of the message

comment
string

The optional comment embedded in the message

type
string

The type of decoded message content

hash
string

The hash of the message content

opcode
integer

The opcode used in the message payload

out_msg_tx_hash
string

The hash of the transaction that emitted this outgoing message

source
string

The source address from which the message was sent

value
string

The amount of nanotons transferred with the message

value_extra_currencies
object

The map of additional currencies included in the message

<dynamic_key>
string

The amount held for each extra currency ID

prev_trans_hash
string

Previous transaction hash

prev_trans_lt
string

Previous transaction logical time

total_fees
string

Total fees of the transaction

total_fees_extra_currencies
object

Extra currencies in the total fees

<dynamic_key>
string

Each key maps to a value of type string

trace_external_hash
string

External hash of the trace

trace_id
string

ID of the trace

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