GET
/
getTransactions
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions
[
  {
    "transaction_id": {
      "lt": "<string>",
      "hash": "<string>"
    },
    "utime": 123,
    "fee": "<string>",
    "storage_fee": "<string>",
    "other_fee": "<string>",
    "transaction_type": "<string>",
    "compute": {},
    "action": {},
    "in_msg": {},
    "out_msgs": [
      "<any>"
    ]
  }
]

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

Shell
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.

Query Parameters

​
address
string
default:EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
required

The address to get transactions for

​
limit
integer
default:10

The maximum number of transactions to return

​
to_lt
integer
default:0

The logical time to start the search from (0 means from the latest)

​
archival
boolean
default:false

Whether to use archival node for the query

Response

200 - application/json

Transaction history for the specified address

The response is of type object[].