getTransactions

curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions

const options = {method: 'GET'};

fetch('https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "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": "<array>"
  }
]

GET

getTransactions

curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions

const options = {method: 'GET'};

fetch('https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getTransactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "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": "<array>"
  }
]

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 your own node endpoint todayStart 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 billing: this method is always archive (2 RUs)Account transaction history can reach arbitrarily far back, so this method is always billed as archive. See Request units — TON method scope.

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

transaction_id

object

Show child attributes

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

Last modified on June 22, 2026

APIs introduction

Node APIs

Faucet API

Chainstack platform API

getTransactions | TON v2

JSON-RPC example

Parameters

Response

Use case

Query Parameters

Response

​JSON-RPC example

​Parameters

​Response

​Use case

Query Parameters

Response

JSON-RPC example

Parameters

Response

Use case