Get block transactions

Returns a summary of transactions in a specific block. Each item contains the account address and transaction ID, but not full transaction details. Use count to limit results and after_lt/after_hash for pagination. Call getTransactions with each transaction ID to get full details.

POST /api/v2/getBlockTransactions

Try it

Get block transactions

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getBlockTransactions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "workchain": "<string>",
  "shard": "<string>",
  "seqno": "<string>",
  "root_hash": "<string>",
  "file_hash": "<string>",
  "after_lt": "<string>",
  "after_hash": "<string>",
  "count": "<string>"
}
'

200

{
  "ok": true,
  "result": {
    "@type": "blocks.transactions",
    "id": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "req_count": 123,
    "incomplete": true,
    "transactions": [
      {
        "@type": "blocks.shortTxId",
        "mode": 123,
        "account": "<string>",
        "lt": "<string>",
        "hash": "<string>"
      }
    ]
  },
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Body

application/json

Request to fetch transactions from a specific block with optional pagination.

workchain · required

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

shard · required

Shard identifier. A signed 64-bit integer. Masterchain uses -9223372036854775808.

seqno · required

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

root_hash · string

Merkle root hash of the block state tree. Used for cryptographic verification.

file_hash · string

Hash of the serialized block data. Together with root_hash, uniquely identifies a block.

after_lt

Return items after this logical time (for pagination).

after_hash · string

Return items after this hash (for pagination within same lt).

count

Maximum number of items to return.

Response

200

application/json

OK

Response containing list of transactions in a block.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: blocks.transactions · required

Object type identifier.

Available options: blocks.transactions

result. id · object · required

Request ID. Pass any string and it will be echoed in the response.

Show child attributes

result.id. @type · enum<string> · default: ton.blockIdExt · required

Object type identifier.

Available options: ton.blockIdExt

result.id. workchain · integer · required

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

result.id. shard · string · required

Shard identifier. A signed 64-bit integer. Masterchain uses -9223372036854775808.

result.id. seqno · integer · required

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

result.id. root_hash · string · required

Merkle root hash of the block state tree. Used for cryptographic verification.

result.id. file_hash · string · required

Hash of the serialized block data. Together with root_hash, uniquely identifies a block.

result. req_count · integer · required

Number of requested transactions

result. incomplete · boolean · required

Indicates if the transaction list is incomplete

result. transactions · object[] · required

List of short transaction identifiers

Show child attributes

result.transactions. @type · enum<string> · default: blocks.shortTxId · required

Object type identifier.

Available options: blocks.shortTxId

result.transactions. mode · integer · required

Transaction mode flags

result.transactions. account · string · required

The account address that this transaction belongs to.

result.transactions. lt · string · required

Logical time of this event. A globally unique counter that orders all blockchain events. Higher values are more recent.

result.transactions. hash · string · required

Unique identifier hash for this object.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.