TONTONDocs
TON CenterV2Transactions

applications/api/toncenter/v2/transactions/get-transactions

GET
/api/v2/getTransactions

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.

Default10
Formatint64
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"
}
{
  "ok": false,
  "code": 401,
  "error": "API key does not exist"
}
{
  "ok": false,
  "code": 403,
  "error": "Network not allowed"
}
{
  "ok": false,
  "code": 422,
  "error": "failed to parse address"
}
{
  "ok": false,
  "code": 429,
  "error": "Ratelimit exceeded"
}
{
  "ok": false,
  "code": 504,
  "error": "LITE_SERVER_NETWORK timeout"
}

Last updated on

applications/api/toncenter/v2/transactions/get-block-transactions-extended

applications/api/toncenter/v2/transactions/get-transactions-standard