Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TOP Group (The Open Platform) Traces API

The Traces API from TOP Group (The Open Platform) — 2 operation(s) for traces.

TOP Group (The Open Platform) Traces 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 Traces. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 17 schemas. It is described by OpenAPI 3.0.0, at version 2.0.0.

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

2 operations 2 paths 17 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

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

Paths & Operations 2

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

Traces 2
GET
/v2/traces/{trace_id}
Get the trace by trace ID or hash of any transaction in trace
getTrace 1 param → 200default
POST
/v2/traces/emulate
Emulate sending message to retrieve with a detailed execution trace
emulateMessageToTrace 1 param body → 200default

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are Transaction (25 properties), Message (19 properties), ComputePhase (8 properties), ActionPhase (7 properties). Each schema is shown below with its type and property counts.

BouncePhaseType
string
ActionPhase
object
7 properties 6 required
Message
object
19 properties 11 required
AccStatusChange
string
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
Transaction
object
25 properties 17 required
StateInit
object
2 properties 2 required
Trace
object
4 properties 2 required
TransactionType
string
AccountStatus
string
EcPreview
object
4 properties 4 required
ComputeSkipReason
string
StoragePhase
object
3 properties 2 required
CreditPhase
object
2 properties 2 required
ExtraCurrency
object
2 properties 2 required
AccountAddress
object
5 properties 3 required
ComputePhase
object
8 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

top-group-traces-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) Emulation 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