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.
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
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.
int32The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.
Block sequence number within the specified workchain and shard.
int32The block's root hash. Together with file_hash, uniquely identifies a block.
The block's file hash. Together with root_hash, uniquely identifies a block.
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.
Account ID in hex or base64 for block transaction pagination. Use together with after_lt from the last transaction in the previous page.
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.
int641 <= value <= 1000040Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/getBlockTransactions?workchain=0&shard=string&seqno=0"{ "ok": true, "result": { "@type": "blocks.transactions", "id": { "@type": "ton.blockIdExt", "workchain": 0, "shard": "string", "seqno": 0, "root_hash": "string", "file_hash": "string" }, "req_count": 0, "incomplete": true, "transactions": [ { "@type": "blocks.shortTxId", "mode": 0, "account": "string", "lt": "string", "hash": "string" } ] }, "@extra": "string"}