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

curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactions",
    "params": {
      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
      "limit": 10,
      "to_lt": 0,
      "archival": false
    }
  }'

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.

Try the getTransactions RPC method yourself