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

Try it

Get transactions

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getTransactions \
  --header 'X-API-Key: <api-key>'

200

{
  "ok": true,
  "result": [
    {
      "@type": "ext.transaction",
      "address": {
        "@type": "accountAddress",
        "account_address": "<string>"
      },
      "account": "<string>",
      "utime": 123,
      "data": "<string>",
      "transaction_id": {
        "@type": "internal.transactionId",
        "lt": "<string>",
        "hash": "<string>"
      },
      "fee": "<string>",
      "storage_fee": "<string>",
      "other_fee": "<string>",
      "out_msgs": [
        {
          "@type": "ext.message",
          "hash": "<string>",
          "source": "<string>",
          "destination": "<string>",
          "value": "<string>",
          "extra_currencies": [
            {
              "@type": "extraCurrency",
              "id": 123,
              "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>"
        }
      ],
      "in_msg": {
        "@type": "ext.message",
        "hash": "<string>",
        "source": "<string>",
        "destination": "<string>",
        "value": "<string>",
        "extra_currencies": [
          {
            "@type": "extraCurrency",
            "id": 123,
            "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>"
}

Authorizations

X-API-Key · string · header · required

Query Parameters

address · string · required

The account address to query. You can use any format: raw (0:abcd), base64 (EQ), or base64url (UQ). The API automatically detects and converts the format. A TON account address. Accepts raw format (workchain:hex like 0:abc...), base64 bounceable (EQ...), base64 non-bounceable (UQ...), or base64url. All formats are automatically detected.

limit · integer<int64> · default: 10

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

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

Transaction hash to start from 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.

to_lt · string · default: 0

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.

archival · boolean · default: false

Request data from archival nodes. Regular nodes only keep recent history (about 2 days). Set to true when querying old transactions or historical state. Archival requests may be slower.

Response

200

application/json

OK

Response containing list of account transactions.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object[] · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: ext.transaction · required

Object type identifier.

Available options: ext.transaction

result. address · object · required

The account address in user-friendly format.

Show child attributes

result.address. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.address. account_address · string

The account address in user-friendly format.

result. account · string · required

The account address that this transaction belongs to.

result. utime · integer · required

Unix timestamp (seconds since 1970-01-01). When this event occurred in real-world time.

result. data · string · required

Raw transaction or contract data in BOC (Bag of Cells) format, base64 encoded.

result. transaction_id · object · required

Reference to this transaction. Use lt and hash to fetch full details.

Show child attributes

result.transaction_id. @type · enum<string> · default: internal.transactionId · required

Object type identifier.

Available options: internal.transactionId

result.transaction_id. lt · string · required

Logical time of this event. A globally unique counter that orders all blockchain events. Higher values are more recent.

result.transaction_id. hash · string · required

Unique identifier hash for this object.

result. fee · string · required

Total fees paid for this transaction in nanotons.

result. storage_fee · string · required

Fees paid for storing the contract state on-chain, in nanotons. Charged based on contract size and time.

result. other_fee · string · required

Computation and action fees in nanotons. Covers gas for executing contract code.

result. out_msgs · object[] · required

Messages sent by this transaction. A transaction can send multiple messages to different destinations.

Show child attributes

result.out_msgs. @type · enum<string> · default: ext.message · required

Object type identifier.

Available options: ext.message

result.out_msgs. hash · string · required

Unique identifier hash for this object.

result.out_msgs. source · string · required

Sender address. Empty string for external messages (sent from outside the blockchain).

result.out_msgs. destination · string · required

Recipient address.

result.out_msgs. value · string · required

Amount of TON transferred in this message, in nanotons (1 TON = 10^9 nanotons).

result.out_msgs. extra_currencies · object[] · required

Non-TON currencies transferred. TON supports multiple native currencies.

Show child attributes

result.out_msgs.extra_currencies. @type · enum<string> · default: extraCurrency · required

Object type identifier.

Available options: extraCurrency

result.out_msgs.extra_currencies. id · integer<int32> · required

Request ID. Pass any string and it will be echoed in the response.

result.out_msgs.extra_currencies. amount · string · required

Balance amount as string.

result.out_msgs. fwd_fee · string · required

Fee for forwarding this message to its destination, in nanotons.

result.out_msgs. ihr_fee · string · required

Instant Hypercube Routing fee in nanotons. Usually 0 as IHR is rarely used.

result.out_msgs. created_lt · string · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

result.out_msgs. body_hash · string · required

Hash of the message body. Use this to verify message content without the full body.

result.out_msgs. msg_data · object · required

The message body containing instructions for the destination contract.

Option 1

Show child attributes

result.out_msgs.msg_data. @type · enum<string> · default: msg.dataRaw

Object type identifier.

Available options: msg.dataRaw

result.out_msgs.msg_data. body · string

Message body in BOC format, base64 encoded.

result.out_msgs.msg_data. init_state · string

Contract init state in base64.

result.out_msgs. message · string

Human-readable comment if the message body is a simple text comment.

result.out_msgs. message_decode_error · string

Error text if the message body couldn't be decoded as a comment.

result. in_msg · object

The incoming message that triggered this transaction. External messages come from outside the blockchain.

Show child attributes

result.in_msg. @type · enum<string> · default: ext.message · required

Object type identifier.

Available options: ext.message

result.in_msg. hash · string · required

Unique identifier hash for this object.

result.in_msg. source · string · required

Sender address. Empty string for external messages (sent from outside the blockchain).

result.in_msg. destination · string · required

Recipient address.

result.in_msg. value · string · required

Amount of TON transferred in this message, in nanotons (1 TON = 10^9 nanotons).

result.in_msg. extra_currencies · object[] · required

Non-TON currencies transferred. TON supports multiple native currencies.

Show child attributes

result.in_msg.extra_currencies. @type · enum<string> · default: extraCurrency · required

Object type identifier.

Available options: extraCurrency

result.in_msg.extra_currencies. id · integer<int32> · required

Request ID. Pass any string and it will be echoed in the response.

result.in_msg.extra_currencies. amount · string · required

Balance amount as string.

result.in_msg. fwd_fee · string · required

Fee for forwarding this message to its destination, in nanotons.

result.in_msg. ihr_fee · string · required

Instant Hypercube Routing fee in nanotons. Usually 0 as IHR is rarely used.

result.in_msg. created_lt · string · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

result.in_msg. body_hash · string · required

Hash of the message body. Use this to verify message content without the full body.

result.in_msg. msg_data · object · required

The message body containing instructions for the destination contract.

Option 1

Show child attributes

result.in_msg.msg_data. @type · enum<string> · default: msg.dataRaw

Object type identifier.

Available options: msg.dataRaw

result.in_msg.msg_data. body · string

Message body in BOC format, base64 encoded.

result.in_msg.msg_data. init_state · string

Contract init state in base64.

result.in_msg. message · string

Human-readable comment if the message body is a simple text comment.

result.in_msg. message_decode_error · string

Error text if the message body couldn't be decoded as a comment.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.