TONTONDocs
TON CenterV2Transactions

applications/api/toncenter/v2/transactions/get-block-transactions-extended

GET
/api/v2/getBlockTransactionsExt

Authorization

X-API-Key<token>

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

In: header

Query Parameters

workchain*integer

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.

Formatint32
shard*string

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

Masterchain block sequence number (block height). Used to query state at a specific point in time. If omitted, returns the current state.

Formatint32
root_hash?string

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

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 the 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

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.

Default40
Formatint64
Range1 <= value <= 10000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/getBlockTransactionsExt?workchain=0&shard=string&seqno=0"
{
  "ok": true,
  "result": {
    "@type": "blocks.transactionsExt",
    "id": {
      "@type": "ton.blockIdExt",
      "workchain": 0,
      "shard": "string",
      "seqno": 0,
      "root_hash": "string",
      "file_hash": "string"
    },
    "req_count": 0,
    "incomplete": true,
    "transactions": [
      {
        "address": {
          "@type": "accountAddress",
          "account_address": "string"
        },
        "utime": 0,
        "data": "string",
        "transaction_id": {
          "@type": "internal.transactionId",
          "lt": "string",
          "hash": "string"
        },
        "fee": "string",
        "storage_fee": "string",
        "other_fee": "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": 0,
              "amount": "string"
            }
          ],
          "fwd_fee": "string",
          "ihr_fee": "string",
          "created_lt": "string",
          "body_hash": "string",
          "msg_data": {
            "@type": "msg.dataRaw",
            "body": "string",
            "init_state": "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": 0,
                "amount": "string"
              }
            ],
            "fwd_fee": "string",
            "ihr_fee": "string",
            "created_lt": "string",
            "body_hash": "string",
            "msg_data": {
              "@type": "msg.dataRaw",
              "body": "string",
              "init_state": "string"
            }
          }
        ],
        "@type": "raw.transactionExt",
        "account": "string"
      }
    ]
  },
  "@extra": "string"
}
{
  "ok": false,
  "code": 401,
  "error": "API key does not exist"
}
{
  "ok": false,
  "code": 403,
  "error": "Network not allowed"
}
{
  "ok": false,
  "code": 422,
  "error": "failed to parse workchain"
}
{
  "ok": false,
  "code": 429,
  "error": "Ratelimit exceeded"
}
{
  "ok": false,
  "code": 504,
  "error": "LITE_SERVER_NETWORK timeout"
}

Last updated on

applications/api/toncenter/v2/transactions/get-block-transactions

applications/api/toncenter/v2/transactions/get-transactions