TON Index (mainnet)
v1.0.0https://ton-index.nownodes.ioTON Index collects data from a full node to PostgreSQL database and provides convenient API to an indexed blockchain.
Authentication
api-keyAuthapiKeyAPI Key: api-key in header
TON Index (mainnet)
API V3 Reference (Index)
Get Masterchain Info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get up-to-date masterchain state.
Response
Successful Response
Get Blocks
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns blocks by specified filters.
Parameters
workchainintegerqueryBlock workchain.
shardstringqueryBlock shard id. Must be sent with workchain. Example: 8000000000000000
seqnointegerqueryBlock block seqno. Must be sent with workchain and shard.
start_utimeintegerqueryQuery blocks with generation UTC timestamp after given timestamp.
end_utimeintegerqueryQuery blocks with generation UTC timestamp before given timestamp
start_ltintegerqueryQuery blocks with lt >= start_lt
end_ltintegerqueryQuery blocks with lt <= end_lt
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringascdescdescquerySort results by UTC timestamp.
Response
Successful Response
Validation Error
Get Shards By Masterchain Block
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Parameters
seqnointegerrequiredqueryMasterchain block seqno
Response
Successful Response
Validation Error
Get Address Book
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns an address book for given address list.
Parameters
addressArray<string>requiredqueryList of addresses in any form. Max: 1024
Response
Successful Response
Validation Error
Get Masterchain Block Shards
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all worchain blocks, that appeared after previous masterchain block.
Note: this method is not equivalent with /api/v2/shards.
Parameters
seqnointegerrequiredqueryMasterchain block seqno
include_mc_blockbooleanfalsequeryInclude masterchain block
Response
Successful Response
Validation Error
Get Transactions
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get transactions by specified filters.
Parameters
workchainintegerqueryBlock workchain.
shardstringqueryBlock shard id. Must be sent with workchain. Example: 8000000000000000
seqnointegerqueryBlock block seqno. Must be sent with workchain and shard. Must be sent in hex form.
accountArray<string>queryList of account addresses to get transactions. Can be sent in hex, base64 or base64url form.
exclude_accountArray<string>queryExclude transactions on specified account addresses
hashstringqueryTransaction hash. Acceptable in hex, base64 and base64url forms.
ltintegerqueryTransaction lt.
start_utimeintegerqueryQuery transactions with generation UTC timestamp after given timestamp.
end_utimeintegerqueryQuery transactions with generation UTC timestamp before given timestamp
start_ltintegerqueryQuery transactions with lt >= start_lt
end_ltintegerqueryQuery transactions with lt <= end_lt
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringascdescdescquerySort transactions by lt.
Response
Successful Response
Validation Error
Get Transactions By Masterchain Block
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns transactions from masterchain block and from all shards.
Parameters
seqnointegerrequiredqueryMasterchain block seqno
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringnoneascdescdescquerySort transactions by lt.
Response
Successful Response
Validation Error
Get Transactions By Message
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get transactions whose inbound/outbound message has the specified hash. This endpoint returns list of Transaction objects since collisions of message hashes can occur.
Parameters
directionstringinoutrequiredqueryMessage direction.
msg_hashstringrequiredqueryMessage hash. Acceptable in hex, base64 and base64url forms.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
Response
Successful Response
Validation Error
Get Adjacent Transactions
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get parent and/or children for specified transaction.
Parameters
hashstringrequiredqueryTransaction hash. Acceptable in hex, base64 and base64url forms.
directionstringinoutbothbothqueryDirection transactions by lt.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringnoneascdescdescquerySort transactions by lt.
Response
Successful Response
Validation Error
Get Messages
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get messages by specified filters.
Parameters
hashstringqueryMessage hash. Acceptable in hex, base64 and base64url forms.
sourcestringqueryThe source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.
destinationstringqueryThe destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.
body_hashstringqueryMessage body hash. Acceptable in hex, base64 and base64url forms.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
Response
Successful Response
Validation Error
Get Nft Collections
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get NFT collections.
Parameters
collection_addressstringqueryNFT collection address. Must be sent in hex, base64 and base64url forms.
owner_addressstringqueryAddress of NFT collection owner. Must be sent in hex, base64 and base64url forms.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
Response
Successful Response
Validation Error
Get Nft Items
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get NFT items.
Parameters
addressstringqueryNFT address. Must be sent in hex, base64 and base64url forms.
owner_addressstringqueryAddress of NFT owner. Must be sent in hex, base64 and base64url forms.
collection_addressstringqueryNFT collection address. Must be sent in hex, base64 and base64url forms.
indexstringqueryNFT Item index. Use it together with collection address.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
Response
Successful Response
Validation Error
Get Nft Transfers
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get NFT transfers by specified filters.
Parameters
addressstringqueryAddress of NFT owner. Must be sent in hex, base64 and base64url forms.
item_addressstringqueryNFT item address. Must be sent in hex, base64 and base64url forms.
collection_addressstringqueryNFT collection address. Must be sent in hex, base64 and base64url forms.
directionstringinoutbothbothqueryDirection transactions by lt.
start_utimeintegerqueryQuery transactions with generation UTC timestamp after given timestamp.
end_utimeintegerqueryQuery transactions with generation UTC timestamp before given timestamp
start_ltintegerqueryQuery transactions with lt >= start_lt
end_ltintegerqueryQuery transactions with lt <= end_lt
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringascdescdescquerySort transactions by lt.
Response
Successful Response
Validation Error
Get Jetton Masters
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get Jetton masters by specified filters.
Parameters
addressstringqueryJetton Master address. Must be sent in hex, base64 and base64url forms.
admin_addressstringqueryAddress of Jetton Masters admin. Must be sent in hex, base64 and base64url forms.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
Response
Successful Response
Validation Error
Get Jetton Wallets
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get Jetton wallets by specified filters.
Parameters
addressstringqueryJetton wallet address. Must be sent in hex, base64 and base64url forms.
owner_addressstringqueryAddress of Jetton wallets owner. Must be sent in hex, base64 and base64url forms.
jetton_addressstringqueryJetton Master. Must be sent in hex, base64 and base64url forms.
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
Response
Successful Response
Validation Error
Get Jetton Transfers
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get Jetton transfers by specified filters.
Parameters
addressstringqueryAccount address. Must be sent in hex, base64 and base64url forms.
jetton_walletstringqueryJetton wallet address. Must be sent in hex, base64 and base64url forms.
jetton_masterstringqueryJetton master address. Must be sent in hex, base64 and base64url forms.
directionstringinoutbothbothqueryDirection transactions by lt.
start_utimeintegerqueryQuery transactions with generation UTC timestamp after given timestamp.
end_utimeintegerqueryQuery transactions with generation UTC timestamp before given timestamp
start_ltintegerqueryQuery transactions with lt >= start_lt
end_ltintegerqueryQuery transactions with lt <= end_lt
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringnoneascdescdescquerySort transactions by lt.
Response
Successful Response
Validation Error
Get Jetton Burns
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get Jetton burns by specified filters.
Parameters
addressstringqueryAccount address. Must be sent in hex, base64 and base64url forms.
jetton_walletstringqueryJetton wallet address. Must be sent in hex, base64 and base64url forms.
jetton_masterstringqueryJetton master address. Must be sent in hex, base64 and base64url forms.
start_utimeintegerqueryQuery transactions with generation UTC timestamp after given timestamp.
end_utimeintegerqueryQuery transactions with generation UTC timestamp before given timestamp
start_ltintegerqueryQuery transactions with lt >= start_lt
end_ltintegerqueryQuery transactions with lt <= end_lt
limitinteger[1, 256]128queryLimit number of queried rows. Use with offset to batch read.
offsetinteger>= 00querySkip first N rows. Use with limit to batch read.
sortstringascdescdescquerySort transactions by lt.
Response
Successful Response
Validation Error
Send Message
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Send external message to TON network.
Body
Message in boc base64 format.
Message in base64 boc serialized format.
bocstringrequiredResponse
Successful Response
Validation Error
Run Get Method
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
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
}
]Body
RunGetMethod request body
Response
Successful Response
Validation Error
Estimate Fee
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Estimate fee for external message.
Body
EstimateFee request body
addressstringrequiredbodystringrequiredinit_codestringinit_datastringignore_chksigbooleantrueResponse
Successful Response
Validation Error
Get Account Information
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Get smart contract information.
Parameters
addressstringrequiredqueryAccount address. Can be sent in raw or user-friendly form.
Response
Successful Response
Validation Error
Get Wallet Information
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
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.
Parameters
addressstringrequiredquerySmart contract address. Can be sent in raw or user-friendly form.
Response
Successful Response
Validation Error