How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TOP Group (The Open Platform) Emulation API

The Emulation API from TOP Group (The Open Platform) — 5 operation(s) for emulation.

TOP Group (The Open Platform) Emulation API is one of 23 APIs that TOP Group (The Open Platform) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Emulation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 5 operations across 5 paths, and defines 76 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against 3 base URLs: https://tonapi.io, https://testnet.tonapi.io, http://localhost:8081.

5 operations 5 paths 76 schemas 5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://tonapi.io
Contact
Resource Areas
1

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 POST. Each is listed below with its method, path, parameters, and response codes.

Emulation 5
POST
/v2/message/decode
Decode message
decodeMessage body → 200default
POST
/v2/events/emulate
Emulate message to event
emulateMessageToEvent 2 params body → 200default
POST
/v2/traces/emulate
Emulate message to trace
emulateMessageToTrace 1 param body → 200default
POST
/v2/wallet/emulate
Emulate message to wallet
emulateMessageToWallet 2 params body → 200default
POST
/v2/accounts/{account_id}/events/emulate
Emulate message to account event
emulateMessageToAccountEvent 3 params body → 200default

Schemas 76

The contract defines 76 schemas that model the data the API accepts and returns. The most detailed are Action (36 properties), Transaction (25 properties), Message (19 properties), NftItem (14 properties). Each schema is shown below with its type and property counts.

OracleRequestAction
object
3 properties 3 required
Risk
object
Conservative upper bound on assets this wallet may lose if the emulated message is sent and the counterparty behaves maliciously. Values may exceed current bal…
6 properties 4 required
ActionPhase
object
7 properties 6 required
TransactionType
string
AccountAddress
object
5 properties 3 required
SetSignatureAllowedAction
object
2 properties 2 required
BouncePhaseType
string
TonTransferAction
object
6 properties 3 required
TrustType
string
Price
object
7 properties 6 required
ImagePreview
object
2 properties 2 required
Protocol
object
2 properties 1 required
Trace
object
4 properties 2 required
Event
object
10 properties 8 required
AccStatusChange
string
OraclePriceFeed
object
3 properties 2 required
ElectionsRecoverStakeAction
object
2 properties 2 required
Message
object
19 properties 11 required
GasRelayAction
object
3 properties 3 required
ValueFlow
object
5 properties 3 required
CreditPhase
object
2 properties 2 required
PurchaseAction
object
5 properties 5 required
DomainRenewAction
object
3 properties 3 required
DepositXTRAction
object
2 properties 2 required
Transaction
object
25 properties 17 required
JettonSwapAction
object
11 properties 5 required
Sale
object
4 properties 3 required
AddExtensionAction
object
2 properties 2 required
WithdrawStakeRequestAction
object
validator's participation in elections
5 properties 3 required
JettonQuantity
object
3 properties 3 required
JettonBurnAction
object
4 properties 4 required
JettonVerificationType
string
ContractDeployAction
object
2 properties 2 required
NftApprovedBy
array
JettonPreview
object
10 properties 7 required
WithdrawTokenStakeRequestAction
object
3 properties 2 required
SmartContractAction
object
7 properties 4 required
DecodedRawMessage
object
2 properties 2 required
Action
object
36 properties 4 required
ExtraCurrencyTransferAction
object
6 properties 4 required
AuctionBidAction
object
5 properties 4 required
ComputeSkipReason
string
LiquidityDepositAction
object
3 properties 3 required
ComputePhase
object
8 properties 1 required
PoolImplementationType
string
DepositTokenStakeAction
object
3 properties 2 required
Metadata
object
2 properties 1 required
WithdrawStakeAction
object
validator's participation in elections
4 properties 4 required
WithdrawXTRAction
object
2 properties 2 required
DepositStakeAction
object
validator's participation in elections
5 properties 4 required
EcPreview
object
4 properties 4 required
SubscriptionAction
object
7 properties 6 required
BuyXTRAction
object
2 properties 2 required
JettonTransferAction
object
9 properties 4 required
NftItem
object
14 properties 6 required
NftPurchaseAction
object
5 properties 5 required
Refund
object
2 properties 2 required
InsufficientFunds
object
Present on an error when a request failed because the source wallet does not hold enough TON to cover the required gas (errorcode 50000).
2 properties 2 required
StoragePhase
object
3 properties 2 required
CurrencyType
string
FlawedJettonTransferAction
object
10 properties 5 required
JettonMintAction
object
4 properties 4 required
EncryptedComment
object
2 properties 2 required
ActionSimplePreview
object
shortly describes what this action is about.
7 properties 3 required
ExtraCurrency
object
2 properties 2 required
ScaledUI
object
2 properties 2 required
MessageConsequences
object
Result of emulating a wallet message on the current blockchain state: describes the expected on-chain consequences (trace, high-level AccountEvent, risk) for t…
3 properties 3 required
StateInit
object
2 properties 2 required
NftItemTransferAction
object
7 properties 1 required
UnSubscriptionAction
object
4 properties 4 required
AccountStatus
string
VaultDepositInfo
object
2 properties 2 required
ElectionsDepositStakeAction
object
2 properties 2 required
RemoveExtensionAction
object
2 properties 2 required
DecodedMessage
object
3 properties 2 required
AccountEvent
object
High-level view over a transaction trace caused by a single inbound message. TonAPI analyses the trace, detects known patterns and groups low-level transaction…
10 properties 9 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

top-group-emulation-api-openapi.yml Raw ↑

Other APIs TOP Group (The Open Platform) publishes across the network.

TOP Group (The Open Platform) Accounts API
TOP Group (The Open Platform) Blockchain API
TOP Group (The Open Platform) Connect API
TOP Group (The Open Platform) DNS API
TOP Group (The Open Platform) Events API
TOP Group (The Open Platform) ExtraCurrency API
TOP Group (The Open Platform) Gasless API
TOP Group (The Open Platform) Jettons API
TOP Group (The Open Platform) Lite Server API
TOP Group (The Open Platform) Migration API
TOP Group (The Open Platform) Multisig API
TOP Group (The Open Platform) NFT API
Where this information came from

This is an independent, third-party profile of TOP Group (The Open Platform) Emulation API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.