transactionsByMasterchainBlock | TON v3

Get Transactions by Masterchain Block

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

const options = {method: 'GET'};

fetch('https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/transactionsByMasterchainBlock', 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/v3/transactionsByMasterchainBlock",
  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/v3/transactionsByMasterchainBlock"

	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/v3/transactionsByMasterchainBlock")

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

{
  "transactions": [
    {
      "hash": "<string>",
      "lt": "<string>",
      "account": "<string>",
      "now": 123,
      "origStatus": "<string>",
      "endStatus": "<string>",
      "totalFees": "<string>"
    }
  ]
}

GET

transactionsByMasterchainBlock

Get Transactions by Masterchain Block

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

const options = {method: 'GET'};

fetch('https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/transactionsByMasterchainBlock', 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/v3/transactionsByMasterchainBlock",
  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/v3/transactionsByMasterchainBlock"

	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/v3/transactionsByMasterchainBlock")

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

{
  "transactions": [
    {
      "hash": "<string>",
      "lt": "<string>",
      "account": "<string>",
      "now": 123,
      "origStatus": "<string>",
      "endStatus": "<string>",
      "totalFees": "<string>"
    }
  ]
}

The transactionsByMasterchainBlock endpoint retrieves a list of transactions for a specific masterchain block in the TON blockchain. This endpoint allows you to fetch transactions associated with a particular block and provides options for pagination and sorting.

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: full or archive by block ageThis method is billed as archive (2 RUs) when the requested block is 128 or more seqno behind the tip, and full (1 RU) otherwise. See Request units — TON method scope.

Parameters

seqno (integer, required) — The sequence number of the masterchain block. Example: 40467413.
limit (integer, optional) — The maximum number of transactions to return. Default: 128.
offset (integer, optional) — The number of transactions to skip before starting to return results. Default: 0.
sort (string, optional) — The sorting order of the transactions. Possible values: asc (ascending) or desc (descending). Default: desc.

Response

transactions (array) — An array of transaction objects, each containing:
- hash (string) — The transaction hash.
- lt (string) — The logical time of the transaction.
- account (string) — The account address involved in the transaction.
- now (integer) — The timestamp of the transaction.
- origStatus (string) — The original status of the account.
- endStatus (string) — The end status of the account.
- totalFees (string) — The total fees for the transaction.

Use case

The transactionsByMasterchainBlock endpoint is useful for various applications that need to analyze or display transaction data for specific blocks:

Block explorers can use this to show all transactions included in a particular masterchain block.
Researchers and analysts can study transaction patterns and volumes for specific blocks.
Developers can use this endpoint to verify transaction inclusion in a specific block.
Auditing tools can track all transactions processed in a given block for compliance or security purposes.

Query Parameters

seqno

integer

default:40467413

required

The sequence number of the masterchain block

limit

integer

default:128

The maximum number of transactions to return

offset

integer

default:0

The number of transactions to skip before starting to return results

sort

enum<string>

default:desc

The sorting order of the transactions

Available options:

asc,

desc

Response

200 - application/json

Successful response

transactions

object[]

Show child attributes

Last modified on June 22, 2026

APIs introduction

Node APIs

Faucet API

Chainstack platform API

transactionsByMasterchainBlock | TON v3

Parameters

Response

Use case

Query Parameters

Response

​Parameters

​Response

​Use case

Query Parameters

Response

Parameters

Response

Use case