transactions

Get Transactions

Returns transaction history for an account. Transactions are returned newest-first. Each transaction shows the incoming message that triggered it, all outgoing messages, and fees paid. For pagination: use the lt and hash from the oldest transaction as the starting point for the next request.

get/api/v2/getTransactions

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/getTransactions
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

addressstring required

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

The account address to query, in raw or user-friendly format.

limitinteger

Maximum number of transactions to return. The default is 10. For accounts with many transactions, use pagination (lt + hash) to fetch more.

ltstring

Starting point for transaction history. Pass the lt from last_transaction_id to start from the most recent, or from a specific transaction to continue pagination.

hashstring

A 256-bit hash value. Accepts either hex format (64 characters) or base64 format (44 characters). Used for block hashes, transaction hashes, and cryptographic proofs.

The 256-bit hash in any form

to_ltstring

Stop fetching when reaching this logical time. Set to 0 (default) to leave the lower logical-time bound unspecified.

archivalboolean

Request data from archival nodes when querying old transactions or historical state.

Response

Returns a list of transactions for the specified account, ordered by logical time.

okboolean required

Returns true if the request succeeded; otherwise false. See the error field for details.

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.