Skip to main content
GET
/
v2
/
accounts
/
{account_id}
/
events
cURL
curl --request GET \
  --url https://tonapi.io/v2/accounts/{account_id}/events
{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "is_scam": true,
        "is_wallet": true,
        "name": "Ton foundation",
        "icon": "https://ton.org/logo.png"
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "is_scam": true,
                "is_wallet": true,
                "name": "Ton foundation",
                "icon": "https://ton.org/logo.png"
              }
            ],
            "action_image": "<string>",
            "value": "5 Ton",
            "value_image": "<string>"
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3,
      "progress": 0.5,
      "ext_msg_hash": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"
    }
  ],
  "next_from": 25713146000001
}

Headers

Accept-Language
string
default:en
Example:

"ru-RU,ru;q=0.5"

Path Parameters

account_id
string<address>
required

account ID

Example:

"0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"

Query Parameters

initiator
boolean
default:false

Show only events that are initiated by this account

subject_only
boolean
default:false

filter actions where requested account is not real subject (for example sender or receiver jettons)

after_lt
integer<int64>

omit this parameter to get last events

Example:

25758317000002

before_lt
integer<int64>

omit this parameter to get last events

Example:

25758317000002

limit
integer
required
Required range: 1 <= x <= 100
Example:

20

start_date
integer<int64>
Required range: x <= 2114380800
Example:

1668436763

end_date
integer<int64>
Required range: x <= 2114380800
Example:

1668436763

sort_order
enum<string>
default:desc

used to sort the result-set in ascending or descending order by lt.

Available options:
desc,
asc

Response

account's events

Paginated list of events for a single account.

events
object[]
required
next_from
integer<int64>
required
Example:

25713146000001