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) Blockchain API

The Blockchain API from TOP Group (The Open Platform) — 22 operation(s) for blockchain.

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

This API exposes 23 operations across 22 paths, and defines 54 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.

23 operations 22 paths 54 schemas 20 GET3 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 23

Across 22 paths, the API surfaces 23 operations — 20 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Blockchain 23
GET
/v2/blockchain/reduced/blocks
Get reduced blockchain blocks data
getReducedBlockchainBlocks 2 params → 200default
GET
/v2/blockchain/blocks/{block_id}
Get blockchain block data
getBlockchainBlock 1 param → 200default
GET
/v2/blockchain/blocks/{block_id}/boc
Download blockchain block BOC
downloadBlockchainBlockBoc 1 param → 200default
GET
/v2/blockchain/masterchain/{masterchain_seqno}/shards
Get blockchain block shards
getBlockchainMasterchainShards 1 param → 200default
GET
/v2/blockchain/masterchain/{masterchain_seqno}/blocks
Get all blocks in all shards and workchains between target and previous masterchain block according to shards last blocks snapshot in masterchain. We don't recommend to build your app around this met…
getBlockchainMasterchainBlocks 1 param → 200default
GET
/v2/blockchain/masterchain/{masterchain_seqno}/transactions
Get all transactions in all shards and workchains between target and previous masterchain block according to shards last blocks snapshot in masterchain. We don't recommend to build your app around th…
getBlockchainMasterchainTransactions 3 params → 200default
GET
/v2/blockchain/masterchain/{masterchain_seqno}/config
Get blockchain config from a specific block, if present.
getBlockchainConfigFromBlock 1 param → 200default
GET
/v2/blockchain/masterchain/{masterchain_seqno}/config/raw
Get raw blockchain config from a specific block, if present.
getRawBlockchainConfigFromBlock 1 param → 200default
GET
/v2/blockchain/blocks/{block_id}/transactions
Get transactions from block
getBlockchainBlockTransactions 1 param → 200default
GET
/v2/blockchain/transactions/{transaction_id}
Get transaction data
getBlockchainTransaction 1 param → 200default
GET
/v2/blockchain/messages/{msg_id}/transaction
Get transaction data by message hash
getBlockchainTransactionByMessageHash 1 param → 200default
GET
/v2/blockchain/validators
Get blockchain validators
getBlockchainValidators → 200default
GET
/v2/blockchain/masterchain-head
Get last known masterchain block
getBlockchainMasterchainHead → 200default
GET
/v2/blockchain/accounts/{account_id}
Get low-level information about an account taken directly from the blockchain.
getBlockchainRawAccount 1 param → 200default
POST
/v2/blockchain/accounts/_bulk
Get low-level information about several accounts taken directly from the blockchain.
getBlockchainRawAccounts body → 200default
GET
/v2/blockchain/accounts/{account_id}/transactions
Get account transactions
getBlockchainAccountTransactions 5 params → 200default
GET
/v2/blockchain/accounts/{account_id}/methods/{method_name}
Execute get method for account
execGetMethodForBlockchainAccount 3 params → 200default
POST
/v2/blockchain/accounts/{account_id}/methods/{method_name}
Execute get method for account
execGetMethodWithBodyForBlockchainAccount 2 params body → 200default
POST
/v2/blockchain/message
Send message to blockchain
sendBlockchainMessage body → 200default
GET
/v2/blockchain/config
Get blockchain config
getBlockchainConfig → 200default
GET
/v2/blockchain/config/raw
Get raw blockchain config
getRawBlockchainConfig → 200default
GET
/v2/blockchain/accounts/{account_id}/inspect
Blockchain account inspect
blockchainAccountInspect 1 param → 200default
GET
/v2/blockchain/libraries/{hash}
Get library cell
getLibraryByHash 1 param → 200default

Schemas 54

The contract defines 54 schemas that model the data the API accepts and returns. The most detailed are BlockchainConfig (46 properties), BlockchainBlock (30 properties), Transaction (25 properties), Message (19 properties). Each schema is shown below with its type and property counts.

ExecGetMethodArgType
string
Data type of the argument value: - nan: Not-a-Number value - null: Null value - tinyint: Decimal integer (e.g., 100500) - int257: 257-bit integer in hex format…
Source
object
1 property 1 required
ConfigProposalSetup
object
8 properties 8 required
BlockCurrencyCollection
object
2 properties 2 required
MsgForwardPrices
object
6 properties 6 required
ActionPhase
object
7 properties 6 required
BouncePhaseType
string
MisbehaviourPunishmentConfig
object
11 properties 11 required
Method
object
2 properties 2 required
Message
object
19 properties 11 required
BlockValueFlow
object
10 properties 9 required
ValidatorsSet
object
6 properties 5 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
AccStatusChange
string
Transaction
object
25 properties 17 required
TvmStackRecord
object
5 properties 1 required
NewConsensusConfig
object
7 properties 3 required
MethodExecutionResult
object
4 properties 3 required
StateInit
object
2 properties 2 required
TransactionType
string
ComputePhase
object
8 properties 1 required
BlockchainBlockShards
object
1 property 1 required
OracleBridgeParams
object
4 properties 4 required
Validator
object
4 properties 4 required
AccountStatus
string
Transactions
object
1 property 1 required
GasLimitPrices
object
9 properties 6 required
BlockParamLimits
object
3 properties 3 required
BlockchainLibrary
object
1 property 1 required
BlockchainRawAccounts
object
1 property 1 required
ReducedBlocks
object
1 property 1 required
BlockchainAccountInspect
object
6 properties 4 required
EcPreview
object
4 properties 4 required
JettonBridgePrices
object
8 properties 6 required
BlockchainBlocks
object
1 property 1 required
Oracle
object
2 properties 2 required
WorkchainDescr
object
12 properties 12 required
ComputeSkipReason
string
BlockchainConfig
object
46 properties 6 required
BlockchainBlock
object
30 properties 27 required
RawBlockchainConfig
object
1 property 1 required
StoragePhase
object
3 properties 2 required
Validators
object
5 properties 5 required
AccountStorageInfo
object
5 properties 5 required
ExtraCurrency
object
2 properties 2 required
CreditPhase
object
2 properties 2 required
ExecGetMethodArg
object
2 properties 2 required
SourceFile
object
5 properties 5 required
ReducedBlock
object
8 properties 7 required
JettonBridgeParams
object
7 properties 4 required
AccountAddress
object
5 properties 3 required
SizeLimitsConfig
object
8 properties 6 required
BlockLimits
object
3 properties 3 required
BlockchainRawAccount
object
11 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

top-group-blockchain-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) 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
TOP Group (The Open Platform) NFT API