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.

GET /api/v2/getBlockTransactionsExt

Try it

Get block transactions (extended)

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getBlockTransactionsExt \
  --header 'X-API-Key: <api-key>'

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

X-API-Key · string · header · required

Query Parameters

workchain · integer<int32> · required

The workchain to query. Use -1 for masterchain (validators, system contracts, config) or 0 for basechain (regular accounts and contracts). Most user transactions happen on workchain 0.

shard · string · required

The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.

seqno · integer<int32> · required

The block sequence number. Each shard numbers its blocks starting from 0. For masterchain, this is also called the block height. Higher numbers are more recent blocks.

root_hash · string

The block's root hash for verification. Together with file_hash, this uniquely and cryptographically identifies a block. Only needed when you require proof of block identity.

file_hash · string

The block's file hash for verification. Together with root_hash, this provides cryptographic proof of block identity. Only needed for trustless verification.

after_lt · string

Pagination cursor. Pass the lt value from the last item in your previous response to get the next page. Transactions and messages are ordered by logical time.

after_hash · string

Secondary pagination cursor for block transactions. When multiple accounts have transactions at the same lt, use this to continue from a specific account.

count · integer<int64> · default: 40

Maximum number of items to return. The default is 40. Use smaller values for faster responses or larger values to reduce the number of API calls.

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

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

Object type identifier.

Available options: blocks.transactionsExt

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: raw.transactionExt · required

Object type identifier. Object type identifier.

result.transactions. address · object · required

The account address in user-friendly format.

Show child attributes

result.transactions.address. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.transactions.address. account_address · string

The account address in user-friendly format.

result.transactions. utime · integer · required

Unix timestamp (seconds since 1970-01-01). When this event occurred in real-world time.

result.transactions. data · string · required

Raw transaction or contract data in BOC (Bag of Cells) format, base64 encoded.

result.transactions. transaction_id · object · required

Reference to this transaction. Use lt and hash to fetch full details.

Show child attributes

result.transactions.transaction_id. @type · enum<string> · default: internal.transactionId · required

Object type identifier.

Available options: internal.transactionId

result.transactions.transaction_id. lt · string · required

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

result.transactions.transaction_id. hash · string · required

Unique identifier hash for this object.

result.transactions. fee · string · required

Total fees paid for this transaction in nanotons.

result.transactions. storage_fee · string · required

Fees paid for storing the contract state on-chain, in nanotons. Charged based on contract size and time.

result.transactions. other_fee · string · required

Computation and action fees in nanotons. Covers gas for executing contract code.

result.transactions. out_msgs · object[] · required

Messages sent by this transaction. A transaction can send multiple messages to different destinations.

Show child attributes

result.transactions.out_msgs. @type · enum<string> · default: raw.message · required

Object type identifier.

Available options: raw.message

result.transactions.out_msgs. hash · string · required

Unique identifier hash for this object.

result.transactions.out_msgs. source · object · required

Sender address. Empty string for external messages (sent from outside the blockchain).

Show child attributes

result.transactions.out_msgs.source. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.transactions.out_msgs.source. account_address · string

The account address in user-friendly format.

result.transactions.out_msgs. destination · object · required

Recipient address.

Show child attributes

result.transactions.out_msgs.destination. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.transactions.out_msgs.destination. account_address · string

The account address in user-friendly format.

result.transactions.out_msgs. value · string · required

Amount of TON transferred in this message, in nanotons (1 TON = 10^9 nanotons).

result.transactions.out_msgs. extra_currencies · object[] · required

Non-TON currencies transferred. TON supports multiple native currencies.

Show child attributes

result.transactions.out_msgs.extra_currencies. @type · enum<string> · default: extraCurrency · required

Object type identifier.

Available options: extraCurrency

result.transactions.out_msgs.extra_currencies. id · integer<int32> · required

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

result.transactions.out_msgs.extra_currencies. amount · string · required

Balance amount as string.

result.transactions.out_msgs. fwd_fee · string · required

Fee for forwarding this message to its destination, in nanotons.

result.transactions.out_msgs. ihr_fee · string · required

Instant Hypercube Routing fee in nanotons. Usually 0 as IHR is rarely used.

result.transactions.out_msgs. created_lt · string · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

result.transactions.out_msgs. body_hash · string · required

Hash of the message body. Use this to verify message content without the full body.

result.transactions.out_msgs. msg_data · object · required

The message body containing instructions for the destination contract.

Option 1

Show child attributes

result.transactions.out_msgs.msg_data. @type · enum<string> · default: msg.dataRaw

Object type identifier.

Available options: msg.dataRaw

result.transactions.out_msgs.msg_data. body · string

Message body in BOC format, base64 encoded.

result.transactions.out_msgs.msg_data. init_state · string

Contract init state in base64.

result.transactions. in_msg · object

The incoming message that triggered this transaction. External messages come from outside the blockchain.

Show child attributes

result.transactions.in_msg. @type · enum<string> · default: raw.message · required

Object type identifier.

Available options: raw.message

result.transactions.in_msg. hash · string · required

Unique identifier hash for this object.

result.transactions.in_msg. source · object · required

Sender address. Empty string for external messages (sent from outside the blockchain).

Show child attributes

result.transactions.in_msg.source. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.transactions.in_msg.source. account_address · string

The account address in user-friendly format.

result.transactions.in_msg. destination · object · required

Recipient address.

Show child attributes

result.transactions.in_msg.destination. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.transactions.in_msg.destination. account_address · string

The account address in user-friendly format.

result.transactions.in_msg. value · string · required

Amount of TON transferred in this message, in nanotons (1 TON = 10^9 nanotons).

result.transactions.in_msg. extra_currencies · object[] · required

Non-TON currencies transferred. TON supports multiple native currencies.

Show child attributes

result.transactions.in_msg.extra_currencies. @type · enum<string> · default: extraCurrency · required

Object type identifier.

Available options: extraCurrency

result.transactions.in_msg.extra_currencies. id · integer<int32> · required

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

result.transactions.in_msg.extra_currencies. amount · string · required

Balance amount as string.

result.transactions.in_msg. fwd_fee · string · required

Fee for forwarding this message to its destination, in nanotons.

result.transactions.in_msg. ihr_fee · string · required

Instant Hypercube Routing fee in nanotons. Usually 0 as IHR is rarely used.

result.transactions.in_msg. created_lt · string · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

result.transactions.in_msg. body_hash · string · required

Hash of the message body. Use this to verify message content without the full body.

result.transactions.in_msg. msg_data · object · required

The message body containing instructions for the destination contract.

Option 1

Show child attributes

result.transactions.in_msg.msg_data. @type · enum<string> · default: msg.dataRaw

Object type identifier.

Available options: msg.dataRaw

result.transactions.in_msg.msg_data. body · string

Message body in BOC format, base64 encoded.

result.transactions.in_msg.msg_data. init_state · string

Contract init state in base64.

result.transactions. account · string

The account address that this transaction belongs to.

@extra · string

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