TON DocsTON Docs
OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Get transactions

GET
/api/v2/getTransactions

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.

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

address*string

The account address to query.

limit?integer

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

Formatint64
Default10
lt?string

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.

hash?string

SHA-256 transaction hash to start pagination from

to_lt?string

Stop fetching when reaching this logical time. Use this to limit the time range of returned transactions. Set to 0 (default) to fetch all available history.

Default0
archival?boolean

Request data from archival nodes. Regular nodes keep at least the last 2 days of history. Set to true when querying old transactions or historical state. Archival requests may be slower.

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/getTransactions?address=string"
{  "ok": true,  "result": [    {      "@type": "ext.transaction",      "address": {        "@type": "accountAddress",        "account_address": "string"      },      "account": "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": "ext.message",        "hash": "string",        "source": "string",        "destination": "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"        },        "message": "string",        "message_decode_error": "string"      },      "out_msgs": [        {          "@type": "ext.message",          "hash": "string",          "source": "string",          "destination": "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"          },          "message": "string",          "message_decode_error": "string"        }      ]    }  ],  "@extra": "string"}