getAccountEvents | TON REST api to TON blockchain explorer

GET

https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Get events for an account. Each event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

initiatorbooleanfalsequery

Show only events that are initiated by this account

subject_onlybooleanfalsequery

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

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 100]requiredquery

start_dateinteger<int64>query

end_dateinteger<int64>query

Response

200OK

account's events

default

Some error during request processing

GET /v2/accounts/{account_id}/events

curl -X GET 'https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events'

const response = await fetch('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events')
data = response.json()

const response = await fetch('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ton-open-api.nownodes.io/v2/accounts/{account_id}/events')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}