Use this file to discover all available pages before exploring further.
The v2 API uses cursor-based pagination to retrieve large result sets in batches. Instead of specifying a page number, the identifier of the last record received is passed to the API, which returns the next batch starting from that point. Because the cursor points at an existing record instead of a page number, new data inserted at the head of the list does not shift already-seen pages.Three endpoints support pagination:
Returns the transaction history of a given account. Results are ordered by logical time in descending order (newest first).Pagination uses lt and hash as a cursor pair. Both must be provided together. These values come from the last transaction in the previous response.
Continue extracting the cursor from the last transaction and fetching the next page.All results have been retrieved when the response returns fewer transactions than the limit. Because the cursor is inclusive, a full subsequent page delivers limit - 1 new transactions (the first item is the cursor duplicate), so a response containing only the cursor transaction (1 item) also counts as an end signal.
Full pagination script
// Replace with a account address you want to paginate, for example:// const address = "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2";const ADDRESS = "<ACCOUNT_ADDRESS>";const LIMIT = 5;async function main() { let allTransactions = []; let lt = undefined; let hash = undefined; let page = 0; while (true) { page++; const params = new URLSearchParams({ address, limit: String(LIMIT) }); if (lt && hash) { params.set("lt", lt); params.set("hash", hash); } const res = await fetch( `https://toncenter.com/api/v2/getTransactions?${params}` ); const { result } = await res.json(); console.log( lt ? `\n--- Page ${page} (cursor: lt=${lt}) ---` : `\n--- Page ${page} (no cursor) ---` ); for (let i = 0; i < result.length; i++) { const tx = result[i]; if (i === 0 && lt && hash) { console.log( ` [skipped] lt: ${tx.transaction_id.lt} hash: ${tx.transaction_id.hash} (duplicate)` ); } else { console.log( ` lt: ${tx.transaction_id.lt} hash: ${tx.transaction_id.hash}` ); } } const isLastPage = result.length < LIMIT; if (lt && hash) { result.shift(); } allTransactions.push(...result); if (isLastPage) break; const last = result[result.length - 1]; lt = last.transaction_id.lt; hash = last.transaction_id.hash; } console.log(`\nTotal unique transactions: ${allTransactions.length}`);}main();
Returns a list of short transaction identifiers for all transactions in a given block.Pagination uses after_lt and after_hash as a cursor pair. Both must be provided together. The response includes an incomplete field that indicates whether more transactions remain in the block.
Returns full transaction details for all transactions in a given block. Pagination works the same way as getBlockTransactions, using after_lt and after_hash as cursors with the incomplete field as the end of results signal. The only difference is that this endpoint returns complete transaction objects instead of short identifiers.
