---
title: "POST /v2/wallet/emulate"
method: POST
path: "/v2/wallet/emulate"
tags: ["Emulation", "Wallet"]
---

# POST /v2/wallet/emulate

`POST /v2/wallet/emulate`

Emulates a wallet message on the current blockchain state and derives its consequences for the signing wallet

## Query parameters

- `currency` string

## Headers

- `Accept-Language` string

## Request body

- object
  - `address_override` string, address — Override the destination wallet address extracted from the BoC. Useful when the BoC was signed with a throwaway key and the real wallet address must be emulated against.
  - `boc` string, cell, required
  - `params` object[] — additional per account configuration
    - `address` string, address, required
    - `balance` integer

## Response `200`

Emulated wallet message consequences

- MessageConsequences — Result of emulating a wallet message on the current blockchain state: describes the expected on-chain consequences (trace, high-level AccountEvent, risk) for the signing wallet. For UI display only.
  - `event` AccountEvent, required — 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.
    - `account` AccountAddress, required
      - `address` string, maybe-address, required
      - `icon` string
      - `is_scam` boolean, required — Is this account was marked as part of scammers activity
      - `is_wallet` boolean, required
      - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
    - `actions` Action[], required
      - `AddExtension` AddExtensionAction
        - `extension` string, address, required
        - `wallet` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `AuctionBid` AuctionBidAction
        - `amount` Price, required
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `auction` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `auction_type` 'DNS.ton' | 'DNS.tg' | 'NUMBER.tg' | 'getgems', required
        - `bidder` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `nft` NftItem
          - `address` string, address, required
          - `approved_by` string[], required
          - `code_hash` string — Hash of the NFT item account code cell (hex)
          - `collection` object
            - `address` string, address, required
            - `description` string, required
            - `name` string, required
          - `data_hash` string — Hash of the NFT item account data cell (hex)
          - `dns` string
          - `include_cnft` boolean
          - `index` integer, required
          - `metadata` object, required
          - `owner` AccountAddress
            - `address` string, maybe-address, required
            - `icon` string
            - `is_scam` boolean, required — Is this account was marked as part of scammers activity
            - `is_wallet` boolean, required
            - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
          - `previews` ImagePreview[]
            - `resolution` string, required
            - `url` string, required
          - `sale` Sale
            - `address` string, address, required
            - `market` AccountAddress, required
              - …
            - `owner` AccountAddress
              - …
            - `price` Price, required
              - …
          - `trust` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
          - `verified` boolean, required — Collection master contract confirmed that this item is part of collection
      - `BuyXTR` BuyXTRAction
        - `amount` string, required
        - `recipient` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `ContractDeploy` ContractDeployAction
        - `address` string, address, required
        - `interfaces` string[], required
      - `DepositStake` DepositStakeAction — validator's participation in elections
        - `amount` integer, required
        - `implementation` 'whales' | 'tf' | 'liquidTF' | 'ffvault', required
        - `pool` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `stake_meta` Price
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `DepositTokenStake` DepositTokenStakeAction
        - `protocol` Protocol, required
          - `image` string
          - `name` string, required
        - `stake_meta` Price
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `DepositXTR` DepositXTRAction
        - `amount` string, required
        - `recipient` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `DomainRenew` DomainRenewAction
        - `contract_address` string, address, required
        - `domain` string, required
        - `renewer` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `ElectionsDepositStake` ElectionsDepositStakeAction
        - `amount` integer, required
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `ElectionsRecoverStake` ElectionsRecoverStakeAction
        - `amount` integer, required
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `ExtraCurrencyTransfer` ExtraCurrencyTransferAction
        - `amount` string, required — amount in quanta of tokens
        - `comment` string
        - `currency` EcPreview, required
          - `decimals` integer, required
          - `id` integer, required
          - `image` string, required
          - `symbol` string, required
        - `encrypted_comment` EncryptedComment
          - `cipher_text` string, required
          - `encryption_type` string, required
        - `recipient` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `sender` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `FlawedJettonTransfer` FlawedJettonTransferAction
        - `comment` string
        - `encrypted_comment` EncryptedComment
          - `cipher_text` string, required
          - `encryption_type` string, required
        - `jetton` JettonPreview, required
          - `address` string, address, required
          - `custom_payload_api_uri` string
          - `decimals` integer, required
          - `description` string
          - `image` string, required
          - `name` string, required
          - `scaled_ui` ScaledUI
            - `denominator` string, required
            - `numerator` string, required
          - `score` integer, required
          - `symbol` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `received_amount` string, required — actually received amount in quanta of tokens
        - `recipient` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `recipients_wallet` string, address, required
        - `refund` Refund
          - `origin` string, required
          - `type` 'DNS.ton' | 'DNS.tg' | 'GetGems', required
        - `sender` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `senders_wallet` string, address, required
        - `sent_amount` string, required — sent amount in quanta of tokens
      - `GasRelay` GasRelayAction
        - `amount` integer, required
        - `relayer` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `target` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `JettonBurn` JettonBurnAction
        - `amount` string, required — amount in quanta of tokens
        - `jetton` JettonPreview, required
          - `address` string, address, required
          - `custom_payload_api_uri` string
          - `decimals` integer, required
          - `description` string
          - `image` string, required
          - `name` string, required
          - `scaled_ui` ScaledUI
            - `denominator` string, required
            - `numerator` string, required
          - `score` integer, required
          - `symbol` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `sender` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `senders_wallet` string, address, required
      - `JettonMint` JettonMintAction
        - `amount` string, required — amount in quanta of tokens
        - `jetton` JettonPreview, required
          - `address` string, address, required
          - `custom_payload_api_uri` string
          - `decimals` integer, required
          - `description` string
          - `image` string, required
          - `name` string, required
          - `scaled_ui` ScaledUI
            - `denominator` string, required
            - `numerator` string, required
          - `score` integer, required
          - `symbol` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `recipient` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `recipients_wallet` string, address, required
      - `JettonSwap` JettonSwapAction
        - `amount_in` string, required
        - `amount_out` string, required
        - `dex` string, required
        - `gram_in` integer
        - `gram_out` integer
        - `jetton_master_in` JettonPreview
          - `address` string, address, required
          - `custom_payload_api_uri` string
          - `decimals` integer, required
          - `description` string
          - `image` string, required
          - `name` string, required
          - `scaled_ui` ScaledUI
            - `denominator` string, required
            - `numerator` string, required
          - `score` integer, required
          - `symbol` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `jetton_master_out` JettonPreview
          - `address` string, address, required
          - `custom_payload_api_uri` string
          - `decimals` integer, required
          - `description` string
          - `image` string, required
          - `name` string, required
          - `scaled_ui` ScaledUI
            - `denominator` string, required
            - `numerator` string, required
          - `score` integer, required
          - `symbol` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `router` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `ton_in` integer — this field will gone after Sept. 2026, use gram_in instead
        - `ton_out` integer — this field will gone after Sept. 2026, use gram_out instead
        - `user_wallet` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `JettonTransfer` JettonTransferAction
        - `amount` string, required — amount in quanta of tokens
        - `comment` string
        - `encrypted_comment` EncryptedComment
          - `cipher_text` string, required
          - `encryption_type` string, required
        - `jetton` JettonPreview, required
          - `address` string, address, required
          - `custom_payload_api_uri` string
          - `decimals` integer, required
          - `description` string
          - `image` string, required
          - `name` string, required
          - `scaled_ui` ScaledUI
            - `denominator` string, required
            - `numerator` string, required
          - `score` integer, required
          - `symbol` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `recipient` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `recipients_wallet` string, address, required
        - `refund` Refund
          - `origin` string, required
          - `type` 'DNS.ton' | 'DNS.tg' | 'GetGems', required
        - `sender` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `senders_wallet` string, address, required
      - `LiquidityDeposit` LiquidityDepositAction
        - `from` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `protocol` Protocol, required
          - `image` string
          - `name` string, required
        - `tokens` VaultDepositInfo[], required
          - `price` Price, required
            - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
            - `decimals` integer, required
            - `image` string, required
            - `jetton` string, address
            - `token_name` string, required
            - `value` string, required
            - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
          - `vault` string, address, required
      - `NftItemTransfer` NftItemTransferAction
        - `comment` string
        - `encrypted_comment` EncryptedComment
          - `cipher_text` string, required
          - `encryption_type` string, required
        - `nft` string, maybe-address, required
        - `payload` string — raw hex encoded payload
        - `recipient` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `refund` Refund
          - `origin` string, required
          - `type` 'DNS.ton' | 'DNS.tg' | 'GetGems', required
        - `sender` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `NftPurchase` NftPurchaseAction
        - `amount` Price, required
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `auction_type` 'DNS.ton' | 'DNS.tg' | 'NUMBER.tg' | 'getgems', required
        - `buyer` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `nft` NftItem, required
          - `address` string, address, required
          - `approved_by` string[], required
          - `code_hash` string — Hash of the NFT item account code cell (hex)
          - `collection` object
            - `address` string, address, required
            - `description` string, required
            - `name` string, required
          - `data_hash` string — Hash of the NFT item account data cell (hex)
          - `dns` string
          - `include_cnft` boolean
          - `index` integer, required
          - `metadata` object, required
          - `owner` AccountAddress
            - `address` string, maybe-address, required
            - `icon` string
            - `is_scam` boolean, required — Is this account was marked as part of scammers activity
            - `is_wallet` boolean, required
            - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
          - `previews` ImagePreview[]
            - `resolution` string, required
            - `url` string, required
          - `sale` Sale
            - `address` string, address, required
            - `market` AccountAddress, required
              - …
            - `owner` AccountAddress
              - …
            - `price` Price, required
              - …
          - `trust` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
          - `verified` boolean, required — Collection master contract confirmed that this item is part of collection
        - `seller` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `OracleRequest` OracleRequestAction
        - `price_feeds` OraclePriceFeed[], required
          - `display_symbol` string, required
          - `id` string, required
          - `rate` number, double
        - `requester` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `response_to` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `Purchase` PurchaseAction
        - `amount` Price, required
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `destination` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `invoice_id` string, required
        - `metadata` Metadata, required
          - `decryption_key` string — hex encoded bytes
          - `encrypted_binary` string, required — hex encoded bytes
        - `source` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `RemoveExtension` RemoveExtensionAction
        - `extension` string, address, required
        - `wallet` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `SetSignatureAllowedAction` SetSignatureAllowedAction
        - `allowed` boolean, required
        - `wallet` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `SmartContractExec` SmartContractAction
        - `contract` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `executor` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `gram_attached` integer, required — amount in nanograms
        - `operation` string, required
        - `payload` string
        - `refund` Refund
          - `origin` string, required
          - `type` 'DNS.ton' | 'DNS.tg' | 'GetGems', required
        - `ton_attached` integer — amount in nanograms
      - `Subscribe` SubscriptionAction
        - `admin` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `amount` integer
        - `beneficiary` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `initial` boolean, required
        - `price` Price, required
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `subscriber` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `subscription` string, address, required
      - `TonTransfer` TonTransferAction
        - `amount` integer, required — amount in nanograms
        - `comment` string
        - `encrypted_comment` EncryptedComment
          - `cipher_text` string, required
          - `encryption_type` string, required
        - `recipient` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `refund` Refund
          - `origin` string, required
          - `type` 'DNS.ton' | 'DNS.tg' | 'GetGems', required
        - `sender` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `UnSubscribe` UnSubscriptionAction
        - `admin` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `beneficiary` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `subscriber` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `subscription` string, address, required
      - `WithdrawStake` WithdrawStakeAction — validator's participation in elections
        - `amount` integer, required
        - `implementation` 'whales' | 'tf' | 'liquidTF' | 'ffvault', required
        - `pool` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `WithdrawStakeRequest` WithdrawStakeRequestAction — validator's participation in elections
        - `amount` integer
        - `implementation` 'whales' | 'tf' | 'liquidTF' | 'ffvault', required
        - `pool` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `stake_meta` Price
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `WithdrawTokenStakeRequest` WithdrawTokenStakeRequestAction
        - `protocol` Protocol, required
          - `image` string
          - `name` string, required
        - `stake_meta` Price
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
        - `staker` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `WithdrawXTR` WithdrawXTRAction
        - `amount` string, required
        - `user` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `base_transactions` string[], required
      - `simple_preview` ActionSimplePreview, required — shortly describes what this action is about.
        - `accounts` AccountAddress[], required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `action_image` string — a link to an image for this particular action.
        - `description` string, required
        - `fiat_value` string — the value of this action expressed in the requested fiat currency.
        - `name` string, required
        - `value` string
        - `value_image` string — a link to an image that depicts this action's asset.
      - `status` 'ok' | 'failed', required
      - `type` 'TonTransfer' | 'ExtraCurrencyTransfer' | 'ContractDeploy' | 'JettonTransfer' | 'FlawedJettonTransfer' | 'JettonBurn' | 'JettonMint' | 'NftItemTransfer' | 'Subscribe' | 'UnSubscribe' | 'AuctionBid' | 'NftPurchase' | 'DepositStake' | 'WithdrawStake' | 'WithdrawStakeRequest' | 'ElectionsDepositStake' | 'ElectionsRecoverStake' | 'JettonSwap' | 'SmartContractExec' | 'DomainRenew' | 'Purchase' | 'AddExtension' | 'RemoveExtension' | 'SetSignatureAllowedAction' | 'GasRelay' | 'DepositTokenStake' | 'WithdrawTokenStakeRequest' | 'LiquidityDeposit' | 'OracleRequest' | 'BuyXTR' | 'DepositXTR' | 'WithdrawXTR' | 'Unknown', required
    - `event_id` string, required
    - `ext_msg_hash` string — Normalized hash of the root external inbound message (hex).
    - `extra` integer, required — Net Gram change for this account not explained by actions, in nanograms: extra = final_balance - initial_balance - sum(explicit Gram changes from actions). extra < 0 - implicit fee, extra > 0 - refund. For UI display only
    - `in_progress` boolean, required — Event trace is not finished yet. Transactions still happening.
    - `is_scam` boolean, required — scam
    - `lt` integer, required
    - `progress` number, float, required — Event completion ratio in [0,1]
    - `timestamp` integer, required
  - `risk` Risk, required — Conservative upper bound on assets this wallet may lose if the emulated message is sent and the counterparty behaves maliciously. Values may exceed current balances (e.g. already-authorized future receipts). For UI display only.
    - `gram` integer, required — Maximum Gram amount that may leave the wallet in the worst case, in nanogram.
    - `jettons` JettonQuantity[], required — Jetton positions that may be debited from the wallet in the worst case.
      - `jetton` JettonPreview, required
        - `address` string, address, required
        - `custom_payload_api_uri` string
        - `decimals` integer, required
        - `description` string
        - `image` string, required
        - `name` string, required
        - `scaled_ui` ScaledUI
          - `denominator` string, required
          - `numerator` string, required
        - `score` integer, required
        - `symbol` string, required
        - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
      - `quantity` string, required
      - `wallet_address` AccountAddress, required
        - `address` string, maybe-address, required
        - `icon` string
        - `is_scam` boolean, required — Is this account was marked as part of scammers activity
        - `is_wallet` boolean, required
        - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
    - `nfts` NftItem[], required — NFT items that may be transferred out of the wallet in the worst case.
      - `address` string, address, required
      - `approved_by` string[], required
      - `code_hash` string — Hash of the NFT item account code cell (hex)
      - `collection` object
        - `address` string, address, required
        - `description` string, required
        - `name` string, required
      - `data_hash` string — Hash of the NFT item account data cell (hex)
      - `dns` string
      - `include_cnft` boolean
      - `index` integer, required
      - `metadata` object, required
      - `owner` AccountAddress
        - `address` string, maybe-address, required
        - `icon` string
        - `is_scam` boolean, required — Is this account was marked as part of scammers activity
        - `is_wallet` boolean, required
        - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `previews` ImagePreview[]
        - `resolution` string, required
        - `url` string, required
      - `sale` Sale
        - `address` string, address, required
        - `market` AccountAddress, required
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `owner` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `price` Price, required
          - `currency_type` 'native' | 'extra_currency' | 'jetton' | 'fiat', required
          - `decimals` integer, required
          - `image` string, required
          - `jetton` string, address
          - `token_name` string, required
          - `value` string, required
          - `verification` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
      - `trust` 'whitelist' | 'graylist' | 'blacklist' | 'none', required
      - `verified` boolean, required — Collection master contract confirmed that this item is part of collection
    - `ton` integer — this field will gone after Sept. 2026, use gram instead
    - `total_equivalent` number, float — Estimated equivalent of all assets at risk (Gram, jettons, NFTs) in the selected currency from currencyQuery (e.g. USD). Approximate, best-effort UI value.
    - `transfer_all_remaining_balance` boolean, required — True if the message semantics allow sweeping all current and future remaining Gram balance of the wallet (e.g. “send all” / drain patterns).
  - `trace` Trace, required
    - `children` Trace[]
    - `emulated` boolean
    - `interfaces` string[], required
    - `transaction` Transaction, required
      - `aborted` boolean, required
      - `account` AccountAddress, required
        - `address` string, maybe-address, required
        - `icon` string
        - `is_scam` boolean, required — Is this account was marked as part of scammers activity
        - `is_wallet` boolean, required
        - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
      - `action_phase` ActionPhase
        - `fwd_fees` integer, required
        - `result_code` integer, required
        - `result_code_description` string
        - `skipped_actions` integer, required
        - `success` boolean, required
        - `total_actions` integer, required
        - `total_fees` integer, required
      - `block` string, required
      - `bounce_phase` 'TrPhaseBounceNegfunds' | 'TrPhaseBounceNofunds' | 'TrPhaseBounceOk'
      - `compute_phase` ComputePhase
        - `exit_code` integer
        - `exit_code_description` string
        - `gas_fees` integer
        - `gas_used` integer
        - `skip_reason` 'cskip_no_state' | 'cskip_bad_state' | 'cskip_no_gas' | 'cskip_suspended'
        - `skipped` boolean, required
        - `success` boolean
        - `vm_steps` integer
      - `credit_phase` CreditPhase
        - `credit` integer, required
        - `fees_collected` integer, required
      - `destroyed` boolean, required
      - `end_balance` integer, required
      - `end_status` 'nonexist' | 'uninit' | 'active' | 'frozen', required
      - `hash` string, required
      - `in_msg` Message
        - `bounce` boolean, required
        - `bounced` boolean, required
        - `created_at` integer, required
        - `created_lt` integer, required
        - `decoded_body` unknown
        - `decoded_op_name` string
        - `destination` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `fwd_fee` integer, required
        - `hash` string, required
        - `ihr_disabled` boolean, required
        - `ihr_fee` integer, required
        - `import_fee` integer, required
        - `init` StateInit
          - `boc` string, cell, required
          - `interfaces` string[], required
        - `msg_type` 'int_msg' | 'ext_in_msg' | 'ext_out_msg', required
        - `op_code` string
        - `raw_body` string, cell — hex-encoded BoC with raw message body
        - `source` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `value` integer, required
        - `value_extra` ExtraCurrency[]
          - `amount` string, required
          - `preview` EcPreview, required
            - `decimals` integer, required
            - `id` integer, required
            - `image` string, required
            - `symbol` string, required
      - `lt` integer, required
      - `orig_status` 'nonexist' | 'uninit' | 'active' | 'frozen', required
      - `out_msgs` Message[], required
        - `bounce` boolean, required
        - `bounced` boolean, required
        - `created_at` integer, required
        - `created_lt` integer, required
        - `decoded_body` unknown
        - `decoded_op_name` string
        - `destination` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `fwd_fee` integer, required
        - `hash` string, required
        - `ihr_disabled` boolean, required
        - `ihr_fee` integer, required
        - `import_fee` integer, required
        - `init` StateInit
          - `boc` string, cell, required
          - `interfaces` string[], required
        - `msg_type` 'int_msg' | 'ext_in_msg' | 'ext_out_msg', required
        - `op_code` string
        - `raw_body` string, cell — hex-encoded BoC with raw message body
        - `source` AccountAddress
          - `address` string, maybe-address, required
          - `icon` string
          - `is_scam` boolean, required — Is this account was marked as part of scammers activity
          - `is_wallet` boolean, required
          - `name` string — Display name. Data collected from different sources like moderation lists, dns, collections names and over.
        - `value` integer, required
        - `value_extra` ExtraCurrency[]
          - `amount` string, required
          - `preview` EcPreview, required
            - `decimals` integer, required
            - `id` integer, required
            - `image` string, required
            - `symbol` string, required
      - `prev_trans_hash` string
      - `prev_trans_lt` integer
      - `raw` string, cell, required — hex encoded boc with raw transaction
      - `state_update_new` string, required
      - `state_update_old` string, required
      - `storage_phase` StoragePhase
        - `fees_collected` integer, required
        - `fees_due` integer
        - `status_change` 'acst_unchanged' | 'acst_frozen' | 'acst_deleted', required
      - `success` boolean, required
      - `total_fees` integer, required
      - `transaction_type` 'TransOrd' | 'TransTickTock' | 'TransSplitPrepare' | 'TransSplitInstall' | 'TransMergePrepare' | 'TransMergeInstall' | 'TransStorage', required
      - `utime` integer, required

## Other responses

- `default` — Some error during request processing

---

[API](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer.md) · [All operations](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonapi/rest-api-to-ton-blockchain-explorer/revisions/fc4add7a71a0/schema)