API V2 Reference

Status

get

Status

Authorizations
api-keystringRequired
Responses
chevron-right
200

status

application/json
rest_onlinebooleanRequiredDefault: true
indexing_latencyintegerRequiredExample: 100
get
/v2/status

Get blockchain block data

get

Get blockchain block data

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID

Example: (-1,8000000000000000,4234234)
Responses
chevron-right
200

blockchain block

application/json
tx_quantityintegerRequiredExample: 130
workchain_idinteger · int32RequiredExample: 0
shardstringRequiredExample: 8000000000000000
seqnointeger · int32RequiredExample: 21734019
root_hashstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
file_hashstringRequiredExample: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
global_idinteger · int32RequiredExample: -239
versioninteger · int32RequiredExample: 0
after_mergebooleanRequiredExample: true
before_splitbooleanRequiredExample: true
after_splitbooleanRequiredExample: true
want_splitbooleanRequiredExample: true
want_mergebooleanRequiredExample: true
key_blockbooleanRequiredExample: true
gen_utimeinteger · int64RequiredExample: 1674826775
start_ltinteger · int64RequiredExample: 23814011000000
end_ltinteger · int64RequiredExample: 23814011000001
vert_seqnointeger · int32RequiredExample: 0
gen_catchain_seqnointeger · int32RequiredExample: 0
min_ref_mc_seqnointeger · int32RequiredExample: 0
prev_key_block_seqnointeger · int32RequiredExample: 0
gen_software_versioninteger · int32OptionalExample: 0
gen_software_capabilitiesinteger · int64OptionalExample: 0
master_refstringOptionalExample: (-1,4234234,8000000000000000)
prev_refsstring[]RequiredExample: ["(-1",4234235,"8000000000000000)"]
in_msg_descr_lengthinteger · int64RequiredExample: 0
out_msg_descr_lengthinteger · int64RequiredExample: 0
rand_seedstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
created_bystringRequiredExample: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
get
/v2/blockchain/blocks/{block_id}

Get blockchain block shards

get

Get blockchain block shards

Authorizations
api-keystringRequired
Path parameters
masterchain_seqnointeger · int32Required

masterchain block seqno

Example: 123456
Responses
chevron-right
200

blockchain block shards

application/json
get
/v2/blockchain/masterchain/{masterchain_seqno}/shards

Get all blocks in all shards

get

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 method because it has problem with scalability and will work very slow in the future.

Authorizations
api-keystringRequired
Path parameters
masterchain_seqnointeger · int32Required

masterchain block seqno

Example: 123456
Responses
chevron-right
200

blockchain blocks

application/json
get
/v2/blockchain/masterchain/{masterchain_seqno}/blocks

Get all transactions in all shards

get

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 this method because it has problem with scalability and will work very slow in the future.

Authorizations
api-keystringRequired
Path parameters
masterchain_seqnointeger · int32Required

masterchain block seqno

Example: 123456
Responses
chevron-right
200

blockchain transactions

application/json
get
/v2/blockchain/masterchain/{masterchain_seqno}/transactions

Get blockchain config from a specific block

get

Get blockchain config from a specific block, if present.

Authorizations
api-keystringRequired
Path parameters
masterchain_seqnointeger · int32Required

masterchain block seqno

Example: 123456
Responses
chevron-right
200

blockchain config

application/json
0stringRequired

config address

1stringRequired

elector address

2stringRequired

minter address

3stringOptional

The address of the transaction fee collector.

4stringRequired

dns root address

rawstringRequired

config boc in base64 format

Example: te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ==
get
/v2/blockchain/masterchain/{masterchain_seqno}/config

Get raw blockchain config from a specific block

get

Get raw blockchain config from a specific block, if present.

Authorizations
api-keystringRequired
Path parameters
masterchain_seqnointeger · int32Required

masterchain block seqno

Example: 123456
Responses
chevron-right
200

blockchain config

application/json
get
/v2/blockchain/masterchain/{masterchain_seqno}/config/raw

Get transactions from block

get

Get transactions from block

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID

Example: (-1,8000000000000000,4234234)
Responses
chevron-right
200

blockchain block transactions

application/json
get
/v2/blockchain/blocks/{block_id}/transactions

Get transaction data

get

Get transaction data

Authorizations
api-keystringRequired
Path parameters
transaction_idstringRequired

transaction ID

Example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Responses
chevron-right
200

blockchain transaction

application/json
hashstringRequiredExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
ltinteger · int64RequiredExample: 25713146000001
successbooleanRequiredExample: true
utimeinteger · int64RequiredExample: 1645544908
orig_statusstring · enumRequiredExample: activePossible values:
end_statusstring · enumRequiredExample: activePossible values:
total_feesinteger · int64RequiredExample: 25713146000001
end_balanceinteger · int64RequiredExample: 25713146000001
transaction_typestring · enumRequiredExample: TransOrdPossible values:
state_update_oldstringRequiredExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
state_update_newstringRequiredExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
blockstringRequiredExample: (-1,4234234,8000000000000000)
prev_trans_hashstringOptionalExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
prev_trans_ltinteger · int64OptionalExample: 25713146000001
bounce_phasestring · enumOptionalExample: cskip_no_statePossible values:
abortedbooleanRequiredExample: true
destroyedbooleanRequiredExample: true
get
/v2/blockchain/transactions/{transaction_id}

Get transaction data by message hash

get

Get transaction data by message hash

Authorizations
api-keystringRequired
Path parameters
msg_idstringRequired

message ID

Example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Responses
chevron-right
200

transaction by message hash

application/json
hashstringRequiredExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
ltinteger · int64RequiredExample: 25713146000001
successbooleanRequiredExample: true
utimeinteger · int64RequiredExample: 1645544908
orig_statusstring · enumRequiredExample: activePossible values:
end_statusstring · enumRequiredExample: activePossible values:
total_feesinteger · int64RequiredExample: 25713146000001
end_balanceinteger · int64RequiredExample: 25713146000001
transaction_typestring · enumRequiredExample: TransOrdPossible values:
state_update_oldstringRequiredExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
state_update_newstringRequiredExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
blockstringRequiredExample: (-1,4234234,8000000000000000)
prev_trans_hashstringOptionalExample: 55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122
prev_trans_ltinteger · int64OptionalExample: 25713146000001
bounce_phasestring · enumOptionalExample: cskip_no_statePossible values:
abortedbooleanRequiredExample: true
destroyedbooleanRequiredExample: true
get
/v2/blockchain/messages/{msg_id}/transaction

Get blockchain validators

get

Get blockchain validators

Authorizations
api-keystringRequired
Responses
chevron-right
200

blockchain validators

application/json
elect_atinteger · int64RequiredExample: 123456789
elect_closeinteger · int64RequiredExample: 123456789
min_stakeinteger · int64RequiredExample: 123456789
total_stakeinteger · int64RequiredExample: 123456789
get
/v2/blockchain/validators

Get last known masterchain block

get

Get last known masterchain block

Authorizations
api-keystringRequired
Responses
chevron-right
200

blockchain masterchain head

application/json
tx_quantityintegerRequiredExample: 130
workchain_idinteger · int32RequiredExample: 0
shardstringRequiredExample: 8000000000000000
seqnointeger · int32RequiredExample: 21734019
root_hashstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
file_hashstringRequiredExample: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
global_idinteger · int32RequiredExample: -239
versioninteger · int32RequiredExample: 0
after_mergebooleanRequiredExample: true
before_splitbooleanRequiredExample: true
after_splitbooleanRequiredExample: true
want_splitbooleanRequiredExample: true
want_mergebooleanRequiredExample: true
key_blockbooleanRequiredExample: true
gen_utimeinteger · int64RequiredExample: 1674826775
start_ltinteger · int64RequiredExample: 23814011000000
end_ltinteger · int64RequiredExample: 23814011000001
vert_seqnointeger · int32RequiredExample: 0
gen_catchain_seqnointeger · int32RequiredExample: 0
min_ref_mc_seqnointeger · int32RequiredExample: 0
prev_key_block_seqnointeger · int32RequiredExample: 0
gen_software_versioninteger · int32OptionalExample: 0
gen_software_capabilitiesinteger · int64OptionalExample: 0
master_refstringOptionalExample: (-1,4234234,8000000000000000)
prev_refsstring[]RequiredExample: ["(-1",4234235,"8000000000000000)"]
in_msg_descr_lengthinteger · int64RequiredExample: 0
out_msg_descr_lengthinteger · int64RequiredExample: 0
rand_seedstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
created_bystringRequiredExample: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
get
/v2/blockchain/masterchain-head

Get Blockchain Raw Account

get

Get low-level information about an account taken directly from the blockchain.

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

raw account

application/json
addressstringRequiredExample: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
balanceinteger · int64RequiredExample: 123456789
codestringOptionalExample: b5ee9c72410104010087000114ff00f4a413f4a0f2c80b0102012002030002d200dfa5ffff76a268698fe9ffe8e42c5267858f90e785ffe4f6aa6467c444ffb365ffc10802faf0807d014035e7a064b87d804077e7857fc10803dfd2407d014035e7a064b86467cd8903a32b9ba4410803ade68afd014035e7a045ea432b6363796103bb7b9363210c678b64b87d807d8040c249b3e4
datastringOptionalExample: b5ee9c7241010101002600004811fd096c0000000000000000000000000000000000000000000000000000000000000000cb78264d
last_transaction_ltinteger · int64RequiredExample: 123456789
last_transaction_hashstringOptionalExample: 088b436a846d92281734236967970612f87fbd64a2cd3573107948379e8e4161
frozen_hashstringOptionalExample: 088b436a846d92281734236967970612f87fbd64a2cd3573107948379e8e4161
statusstring · enumRequiredExample: activePossible values:
get
/v2/blockchain/accounts/{account_id}

Get account transactions

get

Get account transactions

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
after_ltinteger · int64Optional

omit this parameter to get last transactions

Example: 39787624000003
before_ltinteger · int64Optional

omit this parameter to get last transactions

Example: 39787624000003
limitinteger · int32 · min: 1 · max: 1000OptionalDefault: 100Example: 100
Responses
chevron-right
200

blockchain account transactions

application/json
get
/v2/blockchain/accounts/{account_id}/transactions

Execute get method for account

get

Execute get method for account

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
method_namestringRequired

contract get method name

Example: get_wallet_address
Query parameters
argsstring[]Optional

Supported values: "NaN" for NaN type, "Null" for Null type, 10-base digits for tiny int type (Example: 100500), 0x-prefixed hex digits for int257 (Example: 0xfa01d78381ae32), all forms of addresses for slice type (Example: 0:6e731f2e28b73539a7f85ac47ca104d5840b229351189977bb6151d36b5e3f5e), single-root base64-encoded BOC for cell (Example: "te6ccgEBAQEAAgAAAA=="), single-root hex-encoded BOC for slice (Example: b5ee9c72010101010002000000)

Example: ["0:9a33970f617bcd71acf2cd28357c067aa31859c02820d8f01d74c88063a8f4d8"]
Responses
chevron-right
200

method execution result

application/json
successbooleanRequiredExample: true
exit_codeintegerRequired

tvm exit code

Example: 0
decodedanyOptional
get
/v2/blockchain/accounts/{account_id}/methods/{method_name}

Send message to blockchain

post

Send message to blockchain

Authorizations
api-keystringRequired
Body
bocstringOptionalExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
batchstring[] · max: 10OptionalExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
Responses
chevron-right
200

the message has been sent

No content

post
/v2/blockchain/message

No content

Get blockchain config

get

Get blockchain config

Authorizations
api-keystringRequired
Responses
chevron-right
200

blockchain config

application/json
0stringRequired

config address

1stringRequired

elector address

2stringRequired

minter address

3stringOptional

The address of the transaction fee collector.

4stringRequired

dns root address

rawstringRequired

config boc in base64 format

Example: te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ==
get
/v2/blockchain/config

Get raw blockchain config

get

Get raw blockchain config

Authorizations
api-keystringRequired
Responses
chevron-right
200

blockchain config

application/json
get
/v2/blockchain/config/raw

Blockchain account inspect

get

Blockchain account inspect

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

blockchain account inspect

application/json
codestringRequired
code_hashstringRequired
compilerstring · enumOptionalPossible values:
get
/v2/blockchain/accounts/{account_id}/inspect

Decode Message

post

Decode a given message. Only external incoming messages can be decoded currently.

Authorizations
api-keystringRequired
Body
bocstringRequiredExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
Responses
chevron-right
200

decoded message

application/json
destination_wallet_versionstringRequiredExample: v3R2
post
/v2/message/decode

Address Parse

get

parse address and display in all formats

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

all forms and info

application/json
raw_formstringRequiredExample: 0:6e731f2e28b73539a7f85ac47ca104d5840b229351189977bb6151d36b5e3f5e
given_typestringRequired
test_onlybooleanRequired
get
/v2/address/{account_id}/parse

Emulate Message To Event

post

Emulate sending message to blockchain

Authorizations
api-keystringRequired
Query parameters
ignore_signature_checkbooleanOptional
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Body
bocstringRequiredExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
Responses
chevron-right
200

emulated event

application/json
event_idstringRequiredExample: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
timestampinteger · int64RequiredExample: 1234567890
is_scambooleanRequired

scam

Example: false
ltinteger · int64RequiredExample: 25713146000001
in_progressbooleanRequired

Event is not finished yet. Transactions still happening

Example: false
post
/v2/events/emulate

Emulate Message To Trace

post

Emulate sending message to blockchain

Authorizations
api-keystringRequired
Query parameters
ignore_signature_checkbooleanOptional
Body
bocstringRequiredExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
Responses
chevron-right
200

emulated trace

application/json
interfacesstring[]RequiredExample: ["wallet","tep62_item"]
emulatedbooleanOptionalExample: false
post
/v2/traces/emulate

Emulate sending message to blockchain

post

Emulate sending message to blockchain

Authorizations
api-keystringRequired
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Body
bocstringRequiredExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
Responses
chevron-right
200

emulated message

application/json
post
/v2/wallet/emulate

Emulate sending message to blockchain

post

Emulate sending message to blockchain

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
ignore_signature_checkbooleanOptional
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Body
bocstringRequiredExample: te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg
Responses
chevron-right
200

emulated message to account

application/json

An event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.

event_idstringRequiredExample: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
timestampinteger · int64RequiredExample: 1234567890
is_scambooleanRequired

scam

Example: false
ltinteger · int64RequiredExample: 25713146000001
in_progressbooleanRequired

Event is not finished yet. Transactions still happening

Example: false
extrainteger · int64Required

TODO

Example: 3
post
/v2/accounts/{account_id}/events/emulate

Get human-friendly information about several accounts

post

Get human-friendly information about several accounts without low-level details.

Authorizations
api-keystringRequired
Body
account_idsstring[]RequiredExample: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

a list of accounts

application/json
post
/v2/accounts/_bulk

Get human-friendly information about an account without low-level details.

get

Get human-friendly information about an account without low-level details.

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

account

application/json
addressstringRequiredExample: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
balanceinteger · int64RequiredExample: 123456789
last_activityinteger · int64Required

unix timestamp

Example: 123456789
statusstring · enumRequiredExample: activePossible values:
interfacesstring[]OptionalExample: nft_sale
namestringOptionalExample: Ton foundation
is_scambooleanOptionalExample: true
iconstringOptionalExample: https://ton.org/logo.png
memo_requiredbooleanOptionalExample: true
get_methodsstring[]RequiredExample: ["get_item_data"]
is_suspendedbooleanOptional
is_walletbooleanRequired
get
/v2/accounts/{account_id}

Get account's domains

get

Get account's domains

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

account's domains

application/json
domainsstring[]RequiredExample: vasya.ton
get
/v2/accounts/{account_id}/dns/backresolve

Get all Jettons balances by owner address

get

Get all Jettons balances by owner address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
currenciesstring[]Optional

accept ton and all possible fiat currencies, separated by commas

Example: ["ton","usd","rub"]
Responses
chevron-right
200

account jettons balances

application/json
get
/v2/accounts/{account_id}/jettons

Get Account Jettons History

get

Get the transfer jettons history for account

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 1000RequiredExample: 100
start_dateinteger · int64OptionalExample: 1668436763
end_dateinteger · int64OptionalExample: 1668436763
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

account jettons history

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/accounts/{account_id}/jettons/history

Get Account Jetton History By ID

get

Get the transfer jetton history for account and jetton

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
jetton_idstringRequired

jetton ID

Example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Query parameters
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 1000RequiredExample: 100
start_dateinteger · int64OptionalExample: 1668436763
end_dateinteger · int64OptionalExample: 1668436763
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

account jetton history

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/accounts/{account_id}/jettons/{jetton_id}/history

Get Account Nft Items

get

Get all NFT items by owner address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
collectionstringOptional

nft collection

Example: 0:06d811f426598591b32b2c49f29f66c821368e4acb1de16762b04e0174532465
limitinteger · min: 1 · max: 1000OptionalDefault: 1000
offsetintegerOptionalDefault: 0
indirect_ownershipbooleanOptional

Selling nft items in ton implemented usually via transfer items to special selling account. This option enables including items which owned not directly.

Default: false
Responses
chevron-right
200

account nft items

application/json
get
/v2/accounts/{account_id}/nfts

Get Account Nft History

get

Get the transfer nft history

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 1000RequiredExample: 100
start_dateinteger · int64OptionalExample: 1668436763
end_dateinteger · int64OptionalExample: 1668436763
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

nft history

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/accounts/{account_id}/nfts/history

Get events for an account

get

Get events for an account. Each event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
initiatorbooleanOptional

Show only events that are initiated by this account

Default: false
subject_onlybooleanOptional

filter actions where requested account is not real subject (for example sender or receiver jettons)

Default: false
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 100RequiredExample: 20
start_dateinteger · int64OptionalExample: 1668436763
end_dateinteger · int64OptionalExample: 1668436763
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

account's events

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/accounts/{account_id}/events

Get Account Event

get

Get event for an account by event_id

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
event_idstringRequired

event ID or transaction hash in hex (without 0x) or base64url format

Example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Query parameters
subject_onlybooleanOptional

filter actions where requested account is not real subject (for example sender or receiver jettons)

Default: false
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

account's event

application/json

An event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.

event_idstringRequiredExample: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
timestampinteger · int64RequiredExample: 1234567890
is_scambooleanRequired

scam

Example: false
ltinteger · int64RequiredExample: 25713146000001
in_progressbooleanRequired

Event is not finished yet. Transactions still happening

Example: false
extrainteger · int64Required

TODO

Example: 3
get
/v2/accounts/{account_id}/events/{event_id}

Get Account Traces

get

Get traces for account

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
limitinteger · min: 1 · max: 1000OptionalDefault: 100Example: 100
Responses
chevron-right
200

account's traces

application/json
get
/v2/accounts/{account_id}/traces

Get Account Subscriptions

get

Get all subscriptions by wallet address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

account's subscriptions

application/json
get
/v2/accounts/{account_id}/subscriptions

Reindex Account

post

Update internal cache for a particular account

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

success

No content

post
/v2/accounts/{account_id}/reindex

No content

get

Search by account domain name

Authorizations
api-keystringRequired
Query parameters
namestring · min: 3 · max: 15Required
Responses
chevron-right
200

found accounts

application/json
get
/v2/accounts/search

Get Account Dns Expiring

get

Get expiring account .ton dns

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
periodinteger · min: 1 · max: 3660Optional

number of days before expiration

Responses
chevron-right
200

account's expiring .ton dns

application/json
get
/v2/accounts/{account_id}/dns/expiring

Get Account Public Key

get

Get public key by account id

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

account's public key

application/json
public_keystringRequiredExample: NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3...
get
/v2/accounts/{account_id}/publickey

Get Account Diff

get

Get account's balance change

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
start_dateinteger · int64RequiredExample: 1668436763
end_dateinteger · int64RequiredExample: 1668436763
Responses
chevron-right
200

account's balance change

application/json
balance_changeinteger · int64RequiredExample: 1000000000
get
/v2/accounts/{account_id}/diff

Get Dns Info

get

Get full information about domain name

Authorizations
api-keystringRequired
Path parameters
domain_namestringRequired

domain name with .ton or .t.me

Example: wallet.ton
Responses
chevron-right
200

domain info

application/json
namestringRequired
expiring_atinteger · int64Optional

date of expiring. optional. not all domain in ton has expiration date

get
/v2/dns/{domain_name}

Dns Resolve

get

DNS resolve for domain name

Authorizations
api-keystringRequired
Path parameters
domain_namestringRequired

domain name with .ton or .t.me

Example: wallet.ton
Responses
chevron-right
200

dns record

application/json
next_resolverstringOptionalExample: 0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
sitesstring[]RequiredExample: http://12234.ton
storagestringOptional

tonstorage bag id

Example: da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf
get
/v2/dns/{domain_name}/resolve

Get Domain Bids

get

Get domain bids

Authorizations
api-keystringRequired
Path parameters
domain_namestringRequired

domain name with .ton or .t.me

Example: wallet.ton
Responses
chevron-right
200

domain bids

application/json
get
/v2/dns/{domain_name}/bids

Get All Auctions

get

Get all auctions

Authorizations
api-keystringRequired
Query parameters
tldstringOptional

domain filter for current auctions "ton" or "t.me"

Example: ton
Responses
chevron-right
200

auctions

application/json
totalinteger · int64RequiredExample: 1660050553
get
/v2/dns/auctions

Get Nft Collections

get

Get NFT collections

Authorizations
api-keystringRequired
Query parameters
limitinteger · int32 · min: 1 · max: 1000OptionalDefault: 100Example: 15
offsetinteger · int32OptionalDefault: 0Example: 10
Responses
chevron-right
200

nft collections

application/json
get
/v2/nfts/collections

Get Nft Collection

get

Get NFT collection by collection address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

nft collection

application/json
addressstringRequiredExample: 0:FD595F36B4C1535BEC8461490D38EBB9AE3C38DD6ACE17CA63ABE2C6608BE159
next_item_indexinteger · int64RequiredExample: 1
raw_collection_contentstringRequiredExample: 697066733a2f2f516d596e437861746f5178433571584b79773971656768415853626f3544644e6a32387631487669437a47355359
get
/v2/nfts/collections/{account_id}

Get Items From Collection

get

Get NFT items from collection by collection address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
limitinteger · min: 1 · max: 1000OptionalDefault: 1000
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

nft items

application/json
get
/v2/nfts/collections/{account_id}/items

Get Nft Items By Addresses

post

Get NFT items by their addresses

Authorizations
api-keystringRequired
Body
account_idsstring[]RequiredExample: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

nft items

application/json
post
/v2/nfts/_bulk

Get Nft Item By Address

get

Get NFT item by its address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

nft item

application/json
addressstringRequiredExample: 0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B
indexinteger · int64RequiredExample: 58
verifiedbooleanRequiredExample: true
dnsstringOptionalExample: crypto.ton
get
/v2/nfts/{account_id}

Get Nft History By ID

get

Get the transfer nfts history for account

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 1000RequiredExample: 100
start_dateinteger · int64OptionalExample: 1668436763
end_dateinteger · int64OptionalExample: 1668436763
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

nft history

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/nfts/{account_id}/history

Get Trace

get

Get the trace by trace ID or hash of any transaction in trace

Authorizations
api-keystringRequired
Path parameters
trace_idstringRequired

trace ID or transaction hash in hex (without 0x) or base64url format

Example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Responses
chevron-right
200

trace

application/json
interfacesstring[]RequiredExample: ["wallet","tep62_item"]
emulatedbooleanOptionalExample: false
get
/v2/traces/{trace_id}

Get Event

get

Get an event either by event ID or a hash of any transaction in a trace. An event is built on top of a trace which is a series of transactions caused by one inbound message. TonAPI looks for known patterns inside the trace and splits the trace into actions, where a single action represents a meaningful high-level operation like a Jetton Transfer or an NFT Purchase. Actions are expected to be shown to users. It is advised not to build any logic on top of actions because actions can be changed at any time.

Authorizations
api-keystringRequired
Path parameters
event_idstringRequired

event ID or transaction hash in hex (without 0x) or base64url format

Example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

event

application/json
event_idstringRequiredExample: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
timestampinteger · int64RequiredExample: 1234567890
is_scambooleanRequired

scam

Example: false
ltinteger · int64RequiredExample: 25713146000001
in_progressbooleanRequired

Event is not finished yet. Transactions still happening

Example: false
get
/v2/events/{event_id}

Get Account Inscriptions

get

Get all inscriptions by owner address. It's experimental API and can be dropped in the future.

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
limitinteger · min: 1 · max: 1000OptionalDefault: 1000
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

account inscriptions

application/json
get
/v2/experimental/accounts/{account_id}/inscriptions

Get Account Inscriptions History

get

Get the transfer inscriptions history for account. It's experimental API and can be dropped in the future.

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 1000OptionalDefault: 100Example: 100
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

account inscriptions history

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/experimental/accounts/{account_id}/inscriptions/history

Get Account Inscriptions History By Ticker

get

Get the transfer inscriptions history for account. It's experimental API and can be dropped in the future.

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
tickerstringRequiredExample: nano
Query parameters
before_ltinteger · int64Optional

omit this parameter to get last events

Example: 25758317000002
limitinteger · min: 1 · max: 1000OptionalDefault: 100Example: 100
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

account inscriptions history

application/json
next_frominteger · int64RequiredExample: 25713146000001
get
/v2/experimental/accounts/{account_id}/inscriptions/{ticker}/history

Get Inscription Op Template

get

return comment for making operation with inscription. please don't use it if you don't know what you are doing

Authorizations
api-keystringRequired
Query parameters
typestring · enumRequiredExample: ton20Possible values:
destinationstringOptional
commentstringOptional
operationstring · enumRequiredExample: transferPossible values:
amountstringRequiredExample: 1000000000
tickerstringRequiredExample: nano
whostringRequiredExample: UQAs87W4yJHlF8mt29ocA4agnMrLsOP69jC1HPyBUjJay7Mg
Responses
chevron-right
200

inscription op template

application/json
commentstringRequiredExample: comment
destinationstringRequiredExample: 0:0000000000000
get
/v2/experimental/inscriptions/op-template

Get Jettons

get

Get a list of all indexed jetton masters in the blockchain.

Authorizations
api-keystringRequired
Query parameters
limitinteger · int32 · min: 1 · max: 1000OptionalDefault: 100Example: 15
offsetinteger · int32OptionalDefault: 0Example: 10
Responses
chevron-right
200

a list of jettons

application/json
get
/v2/jettons

Get Jetton Info

get

Get jetton metadata by jetton master address

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

jetton info

application/json
mintablebooleanRequiredExample: true
total_supplystringRequiredExample: 311500000000000
verificationstring · enumRequiredPossible values:
holders_countinteger · int32RequiredExample: 2000
get
/v2/jettons/{account_id}

Get Jetton Holders

get

Get jetton's holders

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
limitinteger · min: 1 · max: 1000OptionalDefault: 1000
offsetintegerOptionalDefault: 0
Responses
chevron-right
200

jetton's holders

application/json
totalinteger · int64RequiredExample: 2000
get
/v2/jettons/{account_id}/holders

get Jettons Events

get

Get only jetton transfers in the event

Authorizations
api-keystringRequired
Path parameters
event_idstringRequired

event ID or transaction hash in hex (without 0x) or base64url format

Example: 97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

events

application/json
event_idstringRequiredExample: e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e
timestampinteger · int64RequiredExample: 1234567890
is_scambooleanRequired

scam

Example: false
ltinteger · int64RequiredExample: 25713146000001
in_progressbooleanRequired

Event is not finished yet. Transactions still happening

Example: false
get
/v2/events/{event_id}/jettons

Get Account Nominators Pools

get

All pools where account participates

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

account's pools

application/json
get
/v2/staking/nominator/{account_id}/pools

Get Staking Pool Info

get

Stacking pool info

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

stacking pool info

application/json
get
/v2/staking/pool/{account_id}

Get Staking Pool History

get

Pool history

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

pool history

application/json
get
/v2/staking/pool/{account_id}/history

Get Staking Pools

get

All pools available in network

Authorizations
api-keystringRequired
Query parameters
available_forstringOptional

account ID

Example: 0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621
include_unverifiedbooleanOptional

return also pools not from white list - just compatible by interfaces (maybe dangerous!)

Example: false
Header parameters
Accept-LanguagestringOptionalDefault: enExample: ru-RU,ru;q=0.5
Responses
chevron-right
200

a list of pools

application/json
get
/v2/staking/pools

Get Storage Providers

get

Get TON storage providers deployed to the blockchain.

Authorizations
api-keystringRequired
Responses
chevron-right
200

a list of storage providers

application/json
get
/v2/storage/providers

Get Rates

get

Get the token price to the currency

Authorizations
api-keystringRequired
Query parameters
tokensstring[] · max: 100Required

accept ton and jetton master addresses, separated by commas

Example: ["ton"]
currenciesstring[] · max: 50Required

accept ton and all possible fiat currencies, separated by commas

Example: ["ton","usd","rub"]
Responses
chevron-right
200

tokens rates

application/json
get
/v2/rates

Get Chart Rates

get

Get chart by token

Authorizations
api-keystringRequired
Query parameters
tokenstringRequired

accept jetton master address

currencystringOptionalExample: usd
start_dateinteger · int64OptionalExample: 1668436763
end_dateinteger · int64OptionalExample: 1668436763
points_countinteger · int · max: 200OptionalDefault: 200
Responses
chevron-right
200

token chart

application/json
pointsanyRequired
get
/v2/rates/chart

Get Markets Rates

get

Get the TON price from markets

Authorizations
api-keystringRequired
Responses
chevron-right
200

markets rates

application/json
get
/v2/rates/markets

Get Ton Connect Payload

get

Get a payload for further token receipt

Authorizations
api-keystringRequired
Responses
chevron-right
200

payload

application/json
payloadstringRequiredExample: 84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa
get
/v2/tonconnect/payload

Get Account Info By State Init

post

Get account info by state init

Authorizations
api-keystringRequired
Body
state_initstringRequired
Responses
chevron-right
200

account info

application/json
public_keystringRequiredExample: NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3...
addressstringRequiredExample: 0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b
post
/v2/tonconnect/stateinit

Get Wallet Backup

get

Get backup info

Authorizations
api-keystringRequired
Header parameters
X-TonConnect-AuthstringRequired
Responses
chevron-right
200

get wallet dump

application/json
dumpstringRequired
get
/v2/wallet/backup

Ton Connect Proof

post

Account verification and token issuance

Authorizations
api-keystringRequired
Body
addressstringRequiredExample: 0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b
Responses
chevron-right
200

auth token

application/json
tokenstringRequiredExample: NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3...
post
/v2/wallet/auth/proof

Get Wallets By Public Key

get

Get wallets by public key

Authorizations
api-keystringRequired
Path parameters
public_keystringRequiredExample: NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3...
Responses
chevron-right
200

a list of wallets

application/json
get
/v2/pubkeys/{public_key}/wallets

Get Account Seqno

get

Get account seqno

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Responses
chevron-right
200

account seqno

application/json
seqnointeger · int32Required
get
/v2/wallet/{account_id}/seqno

Get Raw Masterchain Info

get

Get raw masterchain info

Authorizations
api-keystringRequired
Responses
chevron-right
200

raw masterchain info

application/json
state_root_hashstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_masterchain_info

Get Raw Masterchain Info Ext

get

Get raw masterchain info ext

Authorizations
api-keystringRequired
Query parameters
modeinteger · int32Required

mode

Example: 0
Responses
chevron-right
200

raw masterchain info ext

application/json
modeinteger · int32RequiredExample: 0
versioninteger · int32RequiredExample: 257
capabilitiesinteger · int64RequiredExample: 7
last_utimeinteger · int32RequiredExample: 1687938199
nowinteger · int32RequiredExample: 1687938204
state_root_hashstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_masterchain_info_ext

Get Raw Time

get

Get raw time

Authorizations
api-keystringRequired
Responses
chevron-right
200

raw time

application/json
timeinteger · int32RequiredExample: 1687146728
get
/v2/liteserver/get_time

Get Raw Blockchain Block

get

Get raw blockchain block

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Responses
chevron-right
200

raw blockchain block

application/json
datastringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_block/{block_id}

Get Raw Blockchain Block State

get

Get raw blockchain block state

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Responses
chevron-right
200

raw blockchain block state

application/json
root_hashstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
file_hashstringRequiredExample: A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB
datastringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_state/{block_id}

Get Raw Blockchain Block Header

get

Get raw blockchain block header

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Query parameters
modeinteger · int32Required

mode

Example: 0
Responses
chevron-right
200

raw blockchain block header

application/json
modeinteger · int32RequiredExample: 0
header_proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_block_header/{block_id}

Send Raw Message

post

Send raw message to blockchain

Authorizations
api-keystringRequired
Body
bodystringRequired
Responses
chevron-right
200

code

application/json
codeinteger · int32RequiredExample: 200
post
/v2/liteserver/send_message

Get Raw Account State

get

Get raw account state

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
target_blockstringOptional

target block: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Responses
chevron-right
200

raw account state

application/json
shard_proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
statestringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_account_state/{account_id}

Get Raw Shard Info

get

Get raw shard info

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Query parameters
workchaininteger · int32Required

workchain

Example: 1
shardinteger · int64Required

shard

Example: 1
exactbooleanRequired

exact

Example: false
Responses
chevron-right
200

raw shard info

application/json
shard_proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
shard_descrstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_shard_info/{block_id}

Get All Raw Shards Info

get

Get all raw shards info

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Responses
chevron-right
200

all raw shards info

application/json
proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
datastringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_all_shards_info/{block_id}

Get Raw Transactions

get

Get raw transactions

Authorizations
api-keystringRequired
Path parameters
account_idstringRequired

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
Query parameters
countinteger · int32Required

count

Example: 100
ltinteger · int64Required

lt

Example: 23814011000000
hashstringRequired

hash

Example: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
Responses
chevron-right
200

raw transactions

application/json
transactionsstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_transactions/{account_id}

Get Raw List Block Transactions

get

Get raw list block transactions

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Query parameters
modeinteger · int32Required

mode

Example: 0
countinteger · int32Required

count

Example: 100
account_idstringOptional

account ID

Example: EQBzACE3K2aEM-t07gWqwWm1QGPD2MPSeo1ZQsKn6yzhW-wx
ltinteger · int64Optional

lt

Example: 23814011000000
Responses
chevron-right
200

a list of raw block transactions

application/json
req_countinteger · int32RequiredExample: 100
incompletebooleanRequiredExample: true
proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/list_block_transactions/{block_id}

get Raw Block Proof

get

Get raw block proof

Authorizations
api-keystringRequired
Query parameters
known_blockstringRequired

known block: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
target_blockstringOptional

target block: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
modeinteger · int32Required

mode

Example: 0
Responses
chevron-right
200

raw block proof

application/json
completebooleanRequiredExample: true
get
/v2/liteserver/get_block_proof

Get Raw Config

get

Get raw config

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Query parameters
modeinteger · int32Required

mode

Example: 0
Responses
chevron-right
200

raw config

application/json
modeinteger · int32RequiredExample: 0
state_proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
config_proofstringRequiredExample: 131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85
get
/v2/liteserver/get_config_all/{block_id}

Get Raw Shard Block Proof

get

Get raw shard block proof

Authorizations
api-keystringRequired
Path parameters
block_idstringRequired

block ID: (workchain,shard,seqno,root_hash,file_hash)

Example: (-1,8000000000000000,4234234,3E575DAB1D25...90D8,47192E5C46C...BB29)
Responses
chevron-right
200

raw shard block proof

application/json
get
/v2/liteserver/get_shard_block_proof/{block_id}

Last updated