Get block transactions (extended)

Returns full transaction details for all transactions in a block. Unlike getBlockTransactions, this includes complete transaction data with messages, fees, and state changes. Useful for block explorers and indexers that need to process entire blocks.

POST /api/v2/getBlockTransactionsExt

Get block transactions (extended)

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getBlockTransactionsExt \
  --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.transactionsExt",
    "id": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "req_count": 123,
    "incomplete": true,
    "transactions": [
      {
        "@type": "raw.transactionExt",
        "address": {
          "@type": "accountAddress",
          "account_address": "<string>"
        },
        "utime": 123,
        "data": "<string>",
        "transaction_id": {
          "@type": "internal.transactionId",
          "lt": "<string>",
          "hash": "<string>"
        },
        "fee": "<string>",
        "storage_fee": "<string>",
        "other_fee": "<string>",
        "out_msgs": [
          {
            "@type": "raw.message",
            "hash": "<string>",
            "source": {
              "@type": "accountAddress",
              "account_address": "<string>"
            },
            "destination": {
              "@type": "accountAddress",
              "account_address": "<string>"
            },
            "value": "<string>",
            "extra_currencies": [
              {
                "@type": "extraCurrency",
                "id": 123,
                "amount": "<string>"
              }
            ],
            "fwd_fee": "<string>",
            "ihr_fee": "<string>",
            "created_lt": "<string>",
            "body_hash": "<string>",
            "msg_data": {
              "@type": "msg.dataRaw",
              "body": "<string>",
              "init_state": "<string>"
            }
          }
        ],
        "in_msg": {
          "@type": "raw.message",
          "hash": "<string>",
          "source": {
            "@type": "accountAddress",
            "account_address": "<string>"
          },
          "destination": {
            "@type": "accountAddress",
            "account_address": "<string>"
          },
          "value": "<string>",
          "extra_currencies": [
            {
              "@type": "extraCurrency",
              "id": 123,
              "amount": "<string>"
            }
          ],
          "fwd_fee": "<string>",
          "ihr_fee": "<string>",
          "created_lt": "<string>",
          "body_hash": "<string>",
          "msg_data": {
            "@type": "msg.dataRaw",
            "body": "<string>",
            "init_state": "<string>"
          }
        },
        "account": "<string>"
      }
    ]
  },
  "@extra": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

Body

application/json

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

workchain · string integer<int32> · required

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

shard · string integer<int64> · required

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

seqno · string integer<int32> · 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 · string integer<int64>

Return items after this logical time (for pagination).

after_hash · string

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

count · string integer<int64>

Maximum number of items to return.

Response

200

application/json

OK

Response containing detailed transactions from 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

@extra · string

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