Skip to main content
GET
/
api
/
v2
/
getTransactions
Get Transactions
curl --request GET \
  --url https://toncenter.com/api/v2/getTransactions
{
  "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>"
      }
    }
  ]
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

ADDRESS = "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v2.transactions.get_transactions(
            ADDRESS,
        )
        for tx in result:
            print(tx.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

​
address
string
required

Identifier of target TON account in any form

​
limit
integer<int64>
default:10

Maximum number of items in response

​
lt
string

Logical time of the transaction to start from

​
hash
string

The 256-bit hash in any form

​
to_lt
string
default:0

Logical time to stop at

​
archival
boolean
default:false

Whether to use archival node

Response

OK

​
ok
boolean
required
Example:

true

​
result
Transactions · object[]
required