getTransactions
curl --request GET \
--url https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTransactionsimport requests
url = "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTransactions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/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/mt_c524ad9781ae5dccd9ac6f5b0370e/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/mt_c524ad9781ae5dccd9ac6f5b0370e/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))
}HttpResponse<String> response = Unirest.get("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTransactions")
.asString();require 'uri'
require 'net/http'
url = URI("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/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>"
}
]TON node API
getTransactions | TON v2
The getTransactions method retrieves the transaction history for a specific address on the TON blockchain. Chainstack TON v2 reference.
GET
/
getTransactions
getTransactions
curl --request GET \
--url https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTransactionsimport requests
url = "https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTransactions"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/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/mt_c524ad9781ae5dccd9ac6f5b0370e/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/mt_c524ad9781ae5dccd9ac6f5b0370e/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))
}HttpResponse<String> response = Unirest.get("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/api/v2/getTransactions")
.asString();require 'uri'
require 'net/http'
url = URI("https://ton-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e/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/mt_c524ad9781ae5dccd9ac6f5b0370e/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 thegetTransactions 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
Response
200 - application/json
Transaction history for the specified address
Last modified on November 6, 2026
Was this page helpful?