GET
/
getBlockTransactions
getBlockTransactions
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getBlockTransactions
{
  "id": {
    "workchain": 123,
    "shard": "<string>",
    "seqno": 123,
    "root_hash": "<string>",
    "file_hash": "<string>"
  },
  "transactions": [
    {
      "account": "<string>",
      "hash": "<string>",
      "lt": "<string>"
    }
  ],
  "incomplete": true
}

The getBlockTransactions method retrieves transactions from a specific block in the TON blockchain. This method allows you to fetch transaction details for a given block, specified by its workchain, shard, and sequence number.

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.

​
Parameters

  • workchain (integer, required) — The ID of the workchain. Example: -1 for the masterchain.
  • shard (string, required) — The ID of the shard. Example: "-9223372036854775808" for the masterchain.
  • seqno (integer, required) — The sequence number of the block. Example: 39064874.
  • count (integer, optional) — The maximum number of transactions to return. Default: 40.

​
JSON-RPC

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": "getBlockTransactions",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064874,
      "count": 40
    }
  }'

​
Response

  • id (object) — The identifier of the block, containing:
    • workchain (integer) — The workchain ID of the block.
    • shard (string) — The shard ID of the block.
    • seqno (integer) — The sequence number of the block.
    • root_hash (string) — The root hash of the block.
    • file_hash (string) — The file hash of the block.
  • transactions (array of objects) — An array of transaction objects, each containing:
    • account (string) — The account address involved in the transaction.
    • hash (string) — The transaction hash.
    • lt (string) — The logical time of the transaction.
  • incomplete (boolean) — Indicates if the returned list of transactions is incomplete.

​
Use case

A possible use case for the getBlockTransactions method in TON is for blockchain explorers, analytical tools, or any application that needs to examine transactions within specific blocks. This method can be used to:

  1. Display transaction details for a given block in a block explorer.
  2. Analyze transaction patterns or volumes within specific blocks or shards.
  3. Monitor specific accounts by tracking their transactions across blocks.
  4. Implement custom indexing or caching mechanisms for transaction data.

Query Parameters

​
workchain
integer
default:-1
required

The workchain ID

​
shard
string
default:-9223372036854775808
required

The shard ID

​
seqno
integer
default:39064874
required

The sequence number of the block

​
count
integer
default:40

The maximum number of transactions to return

Response

200 - application/json

Transactions from the specified block

The response is of type object.