Events

Get an event either by event ID or a hash of any transaction in a trace. An 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.

GEThttps://ton-open-api.nownodes.io/v2/events/{event_id}

Path parameters

event_id*string

event ID or transaction hash in hex (without 0x) or base64url format

Example: "97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"

Header parameters

Response

200default

event

Body

application/json

event_id*string

Example: "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"

timestamp*integer (int64)

Example: 1234567890

actions*array of Action (object)

value_flow*array of ValueFlow (object)

is_scam*boolean

scam

Example: false

lt*integer (int64)

Example: 25713146000001

in_progress*boolean

Event is not finished yet. Transactions still happening

Example: false

Request

JavaScriptCurlPython

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

Response

200default

{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "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": "text",
        "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": "text",
        "value": "5 Ton",
        "value_image": "text",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          }
        ]
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "value_flow": [
    {
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "ton": 80,
      "fees": 10,
      "jettons": [
        {
          "account": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "jetton": {
            "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
            "name": "Wrapped TON",
            "symbol": "WTON",
            "decimals": 9,
            "image": "https://cache.tonapi.io/images/jetton.jpg",
            "verification": "whitelist"
          },
          "quantity": 10
        }
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false
}