getTransactions | TON v2
The getTransactions
method retrieves the transaction history for a specific address on the TON blockchain. This method allows you to fetch a list of transactions associated with an address, with options to limit the number of results and specify the starting point of the search.
Get you own node endpoint today
Start for free and get your app to production levels immediately. No credit card required.
You can sign up with your GitHub, X, Google, or Microsoft account.
TON pricing is the same for full, archive, v2, v3
There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.
JSON-RPC example
Parameters
address
(string, required) — The address for which to retrieve transactions. Example:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
.limit
(integer, optional) — The maximum number of transactions to return. Default: 10.to_lt
(integer, optional) — The logical time to start the search from (0 means from the latest). Default: 0.archival
(boolean, optional) — Whether to use an archival node for the query. Default: false.
Response
An array of transaction objects, each containing:
transaction_id
(object) — The unique identifier of the transaction, containing:lt
(string) — The logical time of the transaction.hash
(string) — The hash of the transaction.
utime
(integer) — Unix timestamp of the transaction.fee
(string) — The fee for the transaction in nanotons.storage_fee
(string) — The storage fee for the transaction in nanotons.other_fee
(string) — Other fees for the transaction in nanotons.transaction_type
(string) — The type of the transaction.compute
(object) — Computation details of the transaction.action
(object) — Action details of the transaction.in_msg
(object) — Details of the incoming message.out_msgs
(array) — Details of the outgoing messages.
Use case
A possible use case for the getTransactions
method in TON is for blockchain explorers or wallet applications that need to display transaction history for a specific address. This method can be used to show recent transactions, calculate total incoming/outgoing amounts, or analyze transaction patterns for a given address.
Query Parameters
The address to get transactions for
The maximum number of transactions to return
The logical time to start the search from (0 means from the latest)
Whether to use archival node for the query
Response
Unix timestamp of the transaction
The fee for the transaction in nanotons
The storage fee for the transaction in nanotons
Other fees for the transaction in nanotons
The type of the transaction
Computation details of the transaction
Action details of the transaction
Details of the incoming message
Details of the outgoing messages