Skip to main content
POST
/
v2
/
accounts
/
{account_id}
/
events
/
emulate
cURL
curl --request POST \
  --url https://tonapi.io/v2/accounts/{account_id}/events/emulate \
  --header 'Content-Type: application/json' \
  --data '
{
  "boc": "<string>"
}
'
{
  "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"
}

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

​
ignore_signature_check
boolean

Body

application/json

bag-of-cells serialized to hex

​
boc
string<cell>
required

Response

emulated message to account

High-level view over a transaction trace caused by a single inbound message. TonAPI analyses the trace, detects known patterns and groups low-level transactions into user-facing actions (Jetton transfer, NFT purchase, etc.). Actions are a best-effort UI abstraction and may change; do not rely on them for protocol-critical logic.

​
event_id
string
required
Example:

"e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"

​
account
object
required
​
timestamp
integer<int64>
required
Example:

1234567890

​
actions
object[]
required
​
is_scam
boolean
required

scam

Example:

false

​
lt
integer<int64>
required
Example:

25713146000001

​
in_progress
boolean
required

Event trace is not finished yet. Transactions still happening.

Example:

false

​
extra
integer<int64>
required

Net TON change for this account not explained by actions, in nanotons: extra = final_balance - initial_balance - sum(explicit TON changes from actions). extra < 0 - implicit fee, extra > 0 - refund. For UI display only

Example:

3

​
progress
number<float>
required

Event completion ratio in [0,1]

Required range: 0 <= x <= 1
Example:

0.5

​
ext_msg_hash
string

Normalized hash of the root external inbound message (hex).

Example:

"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"