Indexer API
Getting Started
The TON Indexer API provides a powerful way to access indexed blockchain data from the TON network. By storing blockchain data in PostgreSQL, this API allows for efficient queries and retrieval of historical information.
Returns blocks by specified filters.
Block workchain.
Block shard id. Must be sent with workchain. Example: 8000000000000000
Block seqno. Must be sent with workchain and shard.
Query blocks with generation UTC timestamp after given timestamp.
Query blocks with generation UTC timestamp before given timestamp
Query blocks with lt >= start_lt
Query blocks with lt <= end_lt
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort results by UTC timestamp.
Returns one masterchain block (with seqno equal to argument) and some number of shard blocks (with masterchain_block_ref.seqno equal to argument)
Masterchain block seqno
Returns all workchain blocks, that appeared after previous masterchain block.
Note: this method is not equivalent with /api/v2/shards.
Masterchain block seqno
Returns transactions by specified filters.
Block workchain.
Block shard id. Must be sent with workchain. Example: 8000000000000000
Block seqno. Must be sent with workchain and shard. Must be sent in hex form.
List of account addresses to get transactions. Can be sent in hex, base64 or base64url form.
Exclude transactions on specified account addresses
Transaction hash. Acceptable in hex, base64 and base64url forms.
Transaction lt.
Query transactions with generation UTC timestamp after given timestamp.
Query transactions with generation UTC timestamp before given timestamp
Query transactions with lt >= start_lt
Query transactions with lt <= end_lt
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort transactions by lt.
Returns transactions from masterchain block and from all shards.
Masterchain block seqno
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort transactions by lt.
Returns transactions whose inbound/outbound message has the specified hash. This endpoint returns list of Transaction objects since collisions of message hashes can occur.
Message direction.
Message hash. Acceptable in hex, base64 and base64url forms.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Returns parent and/or children for specified transaction.
Transaction hash. Acceptable in hex, base64 and base64url forms.
Direction transactions by lt.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort transactions by lt.
Returns messages by specified filters.
Message hash. Acceptable in hex, base64 and base64url forms.
The source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.
The destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.
Message body hash. Acceptable in hex, base64 and base64url forms.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Returns NFT collections.
NFT collection address. Must be sent in hex, base64 or base64url forms.
Address of NFT collection owner. Must be sent in hex, base64 or base64url forms.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Returns NFT items.
NFT address. Must be sent in hex, base64 or base64url forms.
Address of NFT owner. Must be sent in hex, base64 or base64url forms.
NFT collection address. Must be sent in hex, base64 or base64url forms.
NFT Item index. Use it together with collection address.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Returns NFT transfers by specified filters.
Address of NFT owner. Must be sent in hex, base64 or base64url forms.
NFT item address. Must be sent in hex, base64 or base64url forms.
NFT collection address. Must be sent in hex, base64 or base64url forms.
Direction transactions by lt.
Query transactions with generation UTC timestamp after given timestamp.
Query transactions with generation UTC timestamp before given timestamp
Query transactions with lt >= start_lt
Query transactions with lt <= end_lt
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort transactions by lt.
Returns Jetton masters by specified filters.
Jetton Master address. Must be sent in hex, base64 or base64url forms.
Address of Jetton Master's admin. Must be sent in hex, base64 or base64url forms.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Returns Jetton wallets by specified filters.
Jetton wallet address. Must be sent in hex, base64 or base64url forms.
Address of Jetton wallet's owner. Must be sent in hex, base64 or base64url forms.
Jetton Master. Must be sent in hex, base64 or base64url forms.
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Returns Jetton transfers by specified filters.
Account address. Must be sent in hex, base64 or base64url forms.
Jetton wallet address. Must be sent in hex, base64 or base64url forms.
Jetton master address. Must be sent in hex, base64 or base64url forms.
Direction transactions by lt.
Query transactions with generation UTC timestamp after given timestamp.
Query transactions with generation UTC timestamp before given timestamp
Query transactions with lt >= start_lt
Query transactions with lt <= end_lt
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort transactions by lt.
Returns Jetton burns by specified filters.
Account address. Must be sent in hex, base64 or base64url forms.
Jetton wallet address. Must be sent in hex, base64 or base64url forms.
Jetton master address. Must be sent in hex, base64 or base64url forms.
Query transactions with generation UTC timestamp after given timestamp.
Query transactions with generation UTC timestamp before given timestamp
Query transactions with lt >= start_lt
Query transactions with lt <= end_lt
Limit number of queried rows. Use with offset to batch read.
Skip first N rows. Use with limit to batch read.
Sort transactions by lt.
Send external message in boc base64 format to TON network. Returns message hash in hex format.
External messages are sent from the outside to the smart contracts to make them perform certain actions. For instance, a wallet smart contract expects to receive external messages signed by the wallet's owner.
Message in boc base64 format.
Message in base64 boc serialized format.
Run get method of smart contract. Stack supports only num, cell and slice types:
[
{
"type": "num",
"value": "0x12a"
},
{
"type": "cell",
"value": "te6..." // base64 encoded boc with cell
},
{
"type": "slice",
"value": "te6..." // base64 encoded boc with slice
}
]
RunGetMethod request body
Get wallet smart contract information. The following wallets are supported: v1r1, v1r2, v1r3, v2r1, v2r2, v3r1, v3r2, v4r1, v4r2.
In case the account is not a wallet error code 409 is returned.
Smart contract address. Can be sent in raw or user-friendly form.
Last updated
Was this helpful?