Skip to main content

/api/v3/messages RPC Method

Get messages by specified filters.

Updated on
Nov 27, 2025

Query Parameters

msg_hash
array

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

body_hash
string

Hash of message body.

source
string

The source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.

destination
string

The destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.

opcode
string

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

start_utime
integer

Query messages with created_at >= start_utime.

end_utime
integer

Query messages with created_at >= start_utime.

start_lt
integer

Query messages with created_lt >= start_lt.

end_lt
integer

Query messages with created_lt <= end_lt.

direction
string

Direction of message.

exclude_externals
boolean

Exclude external messages.

only_externals
boolean

Return only external messages.

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

messages
array

Array of messages matching the query filters

bounce
boolean

Whether the message can be bounced back to sender

bounced
boolean

Whether this message is a bounce message

created_at
string

Timestamp when the message was created

created_lt
string

Logical time when the message was created

destination
string

Destination address of the message

fwd_fee
string

Forward fee for message delivery

hash
string

The message hash

hash_norm
string

The normalized message hash

ihr_disabled
boolean

Whether Instant Hypercube Routing is disabled for this message

ihr_fee
string

Fee for Instant Hypercube Routing

import_fee
string

Fee for importing the message

in_msg_tx_hash
string

Hash of the transaction that included this message

init_state
object

Initial state for contract deployment messages

decoded
object

Decoded initial state information

comment
string

Human-readable comment about the initial state

type
string

Type of the initial state data

hash
string

Hash of the initial state data

message_content
object

Content of the message

body
string

Message body in base64 format

decoded
object

Decoded message content information

comment
string

Human-readable comment about the message content

type
string

Type of the message content

hash
string

Hash of the message content

opcode
integer

Operation code of the message

out_msg_tx_hash
string

Hash of the transaction that processed this outgoing message

source
string

Source address of the message

value
string

Amount of TON coins transferred in the message

value_extra_currencies
object

Additional currencies transferred in the message

<dynamic_key>
string

Amount of the specific extra currency, where the key is the currency identifier

address_book
object

A mapping of addresses to their human-readable information

<dynamic_key>
object

Each key maps to a AddressBookRow object

domain
string

The domain name associated with this address

user_friendly
string

Human-readable representation of the address

metadata
object

(Optional) The metadata information about the addresses

<dynamic_field>
object

The mapping to address metadata object with dynamic keys

is_indexed
boolean

The indicator if the address is indexed in the system

token_info
array

The collection of token information associated with this address

description
string

The detailed description of the token

extra
object

The additional custom token metadata fields

<dynamic_field>
object

The custom property with dynamic key for additional token information

image
string

The URL pointing to the token image or icon

name
string

The full name of the token

symbol
string

The short ticker symbol of the token

type
string

The classification or standard of the token

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