TON HTTP API

v2.0.0

Base URLs

https://ton.nownodes.io

https://ton-open-api.nownodes.io

https://ton-index.nownodes.io

This API enables HTTP access to TON blockchain - getting accounts and wallets information, looking up blocks and transactions, sending messages to the blockchain, calling get methods of smart contracts, and more.

In addition to REST API, all methods are available through JSON-RPC endpoint with method equal to method name and params passed as a dictionary.

The response contains a JSON object, which always has a boolean field ok and either error or result. If ok equals true, the request was successful and the result of the query can be found in the result field. In case of an unsuccessful request, ok equals false and the error is explained in the error.

API Key should be sent either as api_key query parameter or X-API-Key header.

Authentication

api-keyAuthapiKey

API Key: api-key in header

TON HTTP API

API V1 Reference

Get Address Information

GET

https://ton.nownodes.io/getAddressInformation

Get basic information about the address: balance, code, data, last_transaction_id.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Address Information

curl -X GET 'https://ton.nownodes.io/getAddressInformation'

const response = await fetch('https://ton.nownodes.io/getAddressInformation', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getAddressInformation')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Extended Address Information

GET

https://ton.nownodes.io/getExtendedAddressInformation

Similar to previous one but tries to parse additional information for known contract types. This method is based on tonlib's function getAccountState. For detecting wallets we recommend to use getWalletInformation.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Extended Address Information

curl -X GET 'https://ton.nownodes.io/getExtendedAddressInformation'

const response = await fetch('https://ton.nownodes.io/getExtendedAddressInformation', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getExtendedAddressInformation')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Wallet Information

GET

https://ton.nownodes.io/getWalletInformation

Retrieve wallet information. This method parses contract state and currently supports more wallet types than getExtendedAddressInformation: simple wallet, standart wallet, v3 wallet, v4 wallet.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Wallet Information

curl -X GET 'https://ton.nownodes.io/getWalletInformation'

const response = await fetch('https://ton.nownodes.io/getWalletInformation', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getWalletInformation')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Transactions

GET

https://ton.nownodes.io/getTransactions

Get transaction history of a given address.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

limitinteger<= 10010query

Maximum number of transactions in response.

ltintegerquery

Logical time of transaction to start with, must be sent with hash.

hashstringquery

Hash of transaction to start with, in base64 or hex encoding , must be sent with lt.

to_ltinteger0query

Logical time of transaction to finish with (to get tx from lt to to_lt).

archivalbooleanfalsequery

By default getTransaction request is processed by any available liteserver. If archival=true only liteservers with full history are used.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Transactions

curl -X GET 'https://ton.nownodes.io/getTransactions'

const response = await fetch('https://ton.nownodes.io/getTransactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getTransactions')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Address Balance

GET

https://ton.nownodes.io/getAddressBalance

Get balance (in nanotons) of a given address.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Address Balance

curl -X GET 'https://ton.nownodes.io/getAddressBalance'

const response = await fetch('https://ton.nownodes.io/getAddressBalance', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getAddressBalance')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Address

GET

https://ton.nownodes.io/getAddressState

Get state of a given address. State can be either unitialized, active or frozen.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Address

curl -X GET 'https://ton.nownodes.io/getAddressState'

const response = await fetch('https://ton.nownodes.io/getAddressState', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getAddressState')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Pack Address

GET

https://ton.nownodes.io/packAddress

Convert an address from raw to human-readable format.

Parameters

addressstringrequiredquery

Identifier of target TON account in raw form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Pack Address

curl -X GET 'https://ton.nownodes.io/packAddress'

const response = await fetch('https://ton.nownodes.io/packAddress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/packAddress')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Unpack Address

GET

https://ton.nownodes.io/unpackAddress

Convert an address from human-readable to raw format.

Parameters

addressstringrequiredquery

Identifier of target TON account in user-friendly form

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Unpack Address

curl -X GET 'https://ton.nownodes.io/unpackAddress'

const response = await fetch('https://ton.nownodes.io/unpackAddress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/unpackAddress')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Masterchain Info

GET

https://ton.nownodes.io/getMasterchainInfo

Get up-to-date masterchain state.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Masterchain Info

curl -X GET 'https://ton.nownodes.io/getMasterchainInfo'

const response = await fetch('https://ton.nownodes.io/getMasterchainInfo', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getMasterchainInfo')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Masterchain Block Signatures

GET

https://ton.nownodes.io/getMasterchainBlockSignatures

Get up-to-date masterchain state.

Parameters

seqnointegerrequiredquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Masterchain Block Signatures

curl -X GET 'https://ton.nownodes.io/getMasterchainBlockSignatures'

const response = await fetch('https://ton.nownodes.io/getMasterchainBlockSignatures', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getMasterchainBlockSignatures')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Shard Block Proof

GET

https://ton.nownodes.io/getShardBlockProof

Get merkle proof of shardchain block.

Parameters

workchainintegerrequiredquery

Block workchain id

shardintegerrequiredquery

Block shard id

seqnointegerrequiredquery

Block seqno

from_seqnointegerquery

Seqno of masterchain block starting from which proof is required. If not specified latest masterchain block is used.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Shard Block Proof

curl -X GET 'https://ton.nownodes.io/getShardBlockProof'

const response = await fetch('https://ton.nownodes.io/getShardBlockProof', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getShardBlockProof')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Consensus Block

GET

https://ton.nownodes.io/getConsensusBlock

Get consensus block and its update timestamp.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Consensus Block

curl -X GET 'https://ton.nownodes.io/getConsensusBlock'

const response = await fetch('https://ton.nownodes.io/getConsensusBlock', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getConsensusBlock')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Lookup Block

GET

https://ton.nownodes.io/lookupBlock

Look up block by either seqno, lt or unixtime.

Parameters

workchainintegerrequiredquery

Workchain id to look up block in

shardintegerrequiredquery

Shard id to look up block in

seqnointegerquery

Block's height

ltintegerquery

Block's logical time

unixtimeintegerquery

Block's unixtime

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Lookup Block

curl -X GET 'https://ton.nownodes.io/lookupBlock'

const response = await fetch('https://ton.nownodes.io/lookupBlock', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/lookupBlock')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Shards

GET

https://ton.nownodes.io/shards

Get shards information.

Parameters

seqnointegerrequiredquery

Masterchain seqno to fetch shards of.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Shards

curl -X GET 'https://ton.nownodes.io/shards'

const response = await fetch('https://ton.nownodes.io/shards', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/shards')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Block Transactions

GET

https://ton.nownodes.io/getBlockTransactions

Get transactions of the given block.

Parameters

workchainintegerrequiredquery

shardintegerrequiredquery

seqnointegerrequiredquery

root_hashstringquery

file_hashstringquery

after_ltintegerquery

after_hashstringquery

countinteger40query

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Block Transactions

curl -X GET 'https://ton.nownodes.io/getBlockTransactions'

const response = await fetch('https://ton.nownodes.io/getBlockTransactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getBlockTransactions')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Block Transactions Ext

GET

https://ton.nownodes.io/getBlockTransactionsExt

Get transactions of the given block.

Parameters

workchainintegerrequiredquery

shardintegerrequiredquery

seqnointegerrequiredquery

root_hashstringquery

file_hashstringquery

after_ltintegerquery

after_hashstringquery

countinteger40query

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Block Transactions Ext

curl -X GET 'https://ton.nownodes.io/getBlockTransactionsExt'

const response = await fetch('https://ton.nownodes.io/getBlockTransactionsExt', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getBlockTransactionsExt')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Block Header

GET

https://ton.nownodes.io/getBlockHeader

Get metadata of a given block.

Parameters

workchainintegerrequiredquery

shardintegerrequiredquery

seqnointegerrequiredquery

root_hashstringquery

file_hashstringquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Block Header

curl -X GET 'https://ton.nownodes.io/getBlockHeader'

const response = await fetch('https://ton.nownodes.io/getBlockHeader', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getBlockHeader')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Config Param

GET

https://ton.nownodes.io/getConfigParam

Get config by id.

Parameters

config_idintegerrequiredquery

Config id

seqnointegerquery

Masterchain seqno. If not specified, latest blockchain state will be used.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Config Param

curl -X GET 'https://ton.nownodes.io/getConfigParam'

const response = await fetch('https://ton.nownodes.io/getConfigParam', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getConfigParam')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Config All

GET

https://ton.nownodes.io/getConfigAll

Get cell with full config.

Parameters

seqnointegerquery

Masterchain seqno. If not specified, latest blockchain state will be used.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Config All

curl -X GET 'https://ton.nownodes.io/getConfigAll'

const response = await fetch('https://ton.nownodes.io/getConfigAll', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getConfigAll')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Out Msg Queue Sizes

GET

https://ton.nownodes.io/getOutMsgQueueSizes

Get info with current sizes of messages queues by shards.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Out Msg Queue Sizes

curl -X GET 'https://ton.nownodes.io/getOutMsgQueueSizes'

const response = await fetch('https://ton.nownodes.io/getOutMsgQueueSizes', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getOutMsgQueueSizes')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Token Data

GET

https://ton.nownodes.io/getTokenData

Get NFT or Jetton information.

Parameters

addressstringrequiredquery

Address of NFT collection/item or Jetton master/wallet smart contract

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Token Data

curl -X GET 'https://ton.nownodes.io/getTokenData'

const response = await fetch('https://ton.nownodes.io/getTokenData', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/getTokenData')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Try Locate Tx

GET

https://ton.nownodes.io/tryLocateTx

Locate outcoming transaction of destination address by incoming message.

Parameters

sourcestringrequiredquery

destinationstringrequiredquery

created_ltintegerrequiredquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Try Locate Tx

curl -X GET 'https://ton.nownodes.io/tryLocateTx'

const response = await fetch('https://ton.nownodes.io/tryLocateTx', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/tryLocateTx')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Try Locate Result Tx

GET

https://ton.nownodes.io/tryLocateResultTx

Same as previous. Locate outcoming transaction of destination address by incoming message

Parameters

sourcestringrequiredquery

destinationstringrequiredquery

created_ltintegerrequiredquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Try Locate Result Tx

curl -X GET 'https://ton.nownodes.io/tryLocateResultTx'

const response = await fetch('https://ton.nownodes.io/tryLocateResultTx', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/tryLocateResultTx')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Get Try Locate Source Tx

GET

https://ton.nownodes.io/tryLocateSourceTx

Locate incoming transaction of source address by outcoming message.

Parameters

sourcestringrequiredquery

destinationstringrequiredquery

created_ltintegerrequiredquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Get Try Locate Source Tx

curl -X GET 'https://ton.nownodes.io/tryLocateSourceTx'

const response = await fetch('https://ton.nownodes.io/tryLocateSourceTx', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/tryLocateSourceTx')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Detect Address

GET

https://ton.nownodes.io/detectAddress

Get all possible address forms.

Parameters

addressstringrequiredquery

Identifier of target TON account in any form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Detect Address

curl -X GET 'https://ton.nownodes.io/detectAddress'

const response = await fetch('https://ton.nownodes.io/detectAddress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/detectAddress')
data = response.json()

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Send Boc

POST

https://ton.nownodes.io/sendBoc

Send serialized boc file: fully packed and serialized external message to blockchain.

Body

application/json

bocstringrequired

b64 encoded bag of cells

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Send Boc

curl -X POST 'https://ton.nownodes.io/sendBoc' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "string"
  }'

const response = await fetch('https://ton.nownodes.io/sendBoc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "string"
}

response = requests.post('https://ton.nownodes.io/sendBoc', json=payload)
data = response.json()

Request Body

{
  "boc": "string"
}

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Send Boc Return Hash

POST

https://ton.nownodes.io/sendBocReturnHash

Send serialized boc file: fully packed and serialized external message to blockchain. The method returns message hash.

Body

application/json

bocstringrequired

b64 encoded bag of cells

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Send Boc Return Hash

curl -X POST 'https://ton.nownodes.io/sendBocReturnHash' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "string"
  }'

const response = await fetch('https://ton.nownodes.io/sendBocReturnHash', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "string"
}

response = requests.post('https://ton.nownodes.io/sendBocReturnHash', json=payload)
data = response.json()

Request Body

{
  "boc": "string"
}

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Send Query

POST

https://ton.nownodes.io/sendQuery

Send query - unpacked external message. This method takes address, body and init-params (if any), packs it to external message and sends to network. All params should be boc-serialized.

Body

application/json

addressstringrequired

Address in any format

bodystringrequired

b64-encoded boc-serialized cell with message body

init_codestring

b64-encoded boc-serialized cell with init-code

init_datastring

b64-encoded boc-serialized cell with init-data

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Send Query

curl -X POST 'https://ton.nownodes.io/sendQuery' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "string",
    "body": "string",
    "init_code": "",
    "init_data": ""
  }'

const response = await fetch('https://ton.nownodes.io/sendQuery', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "string",
      "body": "string",
      "init_code": "",
      "init_data": ""
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "string",
  "body": "string",
  "init_code": "",
  "init_data": ""
}

response = requests.post('https://ton.nownodes.io/sendQuery', json=payload)
data = response.json()

Request Body

{
  "address": "string",
  "body": "string",
  "init_code": "",
  "init_data": ""
}

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Estimate Fee

POST

https://ton.nownodes.io/estimateFee

Estimate fees required for query processing. body, init-code and init-data accepted in serialized format (b64-encoded).

Body

application/json

addressstringrequired

Address in any format

bodystringrequired

b64-encoded cell with message body

init_codestring

b64-encoded cell with init-code

init_datastring

b64-encoded cell with init-data

ignore_chksigbooleantrue

If true during test query processing assume that all chksig operations return True

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Estimate Fee

curl -X POST 'https://ton.nownodes.io/estimateFee' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "string",
    "body": "string",
    "init_code": "",
    "init_data": "",
    "ignore_chksig": true
  }'

const response = await fetch('https://ton.nownodes.io/estimateFee', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "string",
      "body": "string",
      "init_code": "",
      "init_data": "",
      "ignore_chksig": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "string",
  "body": "string",
  "init_code": "",
  "init_data": "",
  "ignore_chksig": True
}

response = requests.post('https://ton.nownodes.io/estimateFee', json=payload)
data = response.json()

Request Body

{
  "address": "string",
  "body": "string",
  "init_code": "",
  "init_data": "",
  "ignore_chksig": true
}

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Run Get Method

POST

https://ton.nownodes.io/runGetMethod

Run get method on smart contract.

Body

application/json

addressstringrequired

Contract address

methodstring | integerrequired

Method name or method id

stackArray<Array<any>>required

Array of stack elements: [['num',3], ['cell', cell_object], ['slice', slice_object]]

seqnointeger

Seqno of masterchain block at which moment the Get Method is to be executed

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Run Get Method

curl -X POST 'https://ton.nownodes.io/runGetMethod' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "string",
    "method": "string",
    "stack": [
      []
    ],
    "seqno": 0
  }'

const response = await fetch('https://ton.nownodes.io/runGetMethod', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "string",
      "method": "string",
      "stack": [
        []
      ],
      "seqno": 0
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "string",
  "method": "string",
  "stack": [
    []
  ],
  "seqno": 0
}

response = requests.post('https://ton.nownodes.io/runGetMethod', json=payload)
data = response.json()

Request Body

{
  "address": "string",
  "method": "string",
  "stack": [
    []
  ],
  "seqno": 0
}

200

{
  "ok": true,
  "result": "string",
  "error": "string",
  "code": 0
}

Jsonrpc Handler

POST

https://ton.nownodes.io/jsonRPC

All methods in the API are available through JSON-RPC protocol (spec).

Body

application/json

methodstringrequired

paramsobject[object Object]

idstring

jsonrpcstring

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

504Gateway Timeout

Lite Server Timeout

Authorization

api-keyAuthapiKey in header

Jsonrpc Handler

curl -X POST 'https://ton.nownodes.io/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "string",
    "params": {},
    "id": "string",
    "jsonrpc": "string"
  }'

const response = await fetch('https://ton.nownodes.io/jsonRPC', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "method": "string",
      "params": {},
      "id": "string",
      "jsonrpc": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "method": "string",
  "params": {},
  "id": "string",
  "jsonrpc": "string"
}

response = requests.post('https://ton.nownodes.io/jsonRPC', json=payload)
data = response.json()

Request Body

{
  "method": "string",
  "params": {},
  "id": "string",
  "jsonrpc": "string"
}

200

{
  "ok": true,
  "error": "string",
  "code": 0,
  "id": "string",
  "jsonrpc": "2.0"
}

REST api to TON blockchain explorer

API V2 Reference

GET

https://ton.nownodes.io/v2/status

Status

Response

200OK

status

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/status

curl -X GET 'https://ton.nownodes.io/v2/status'

const response = await fetch('https://ton.nownodes.io/v2/status', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/status')
data = response.json()

{
  "rest_online": true,
  "indexing_latency": 100
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/blocks/{block_id}

Get blockchain block data

Parameters

block_idstringrequiredpath

block ID

Response

200OK

blockchain block

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/blocks/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/blockchain/blocks/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/blocks/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/blocks/{block_id}')
data = response.json()

{
  "tx_quantity": 130,
  "value_flow": {
    "from_prev_blk": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "to_next_blk": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "imported": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "exported": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "fees_collected": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "burned": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "fees_imported": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "recovered": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "created": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "minted": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    }
  },
  "workchain_id": 0,
  "shard": 8000000000000000,
  "seqno": 21734019,
  "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB",
  "global_id": -239,
  "version": 0,
  "after_merge": true,
  "before_split": true,
  "after_split": true,
  "want_split": true,
  "want_merge": true,
  "key_block": true,
  "gen_utime": 1674826775,
  "start_lt": 23814011000000,
  "end_lt": 23814011000001,
  "vert_seqno": 0,
  "gen_catchain_seqno": 0,
  "min_ref_mc_seqno": 0,
  "prev_key_block_seqno": 0,
  "gen_software_version": 0,
  "gen_software_capabilities": 0,
  "master_ref": "(-1,4234234,8000000000000000)",
  "prev_refs": [
    [
      "(-1",
      4234235,
      "8000000000000000)"
    ]
  ],
  "in_msg_descr_length": 0,
  "out_msg_descr_length": 0,
  "rand_seed": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "created_by": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/shards

Get blockchain block shards

Parameters

masterchain_seqnointeger<int32>requiredpath

masterchain block seqno

Response

200OK

blockchain block shards

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/masterchain/{masterchain_seqno}/shards

curl -X GET 'https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/shards'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/shards', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/shards')
data = response.json()

{
  "shards": [
    {
      "last_known_block_id": "(0,8000000000000000,4234234)"
    }
  ]
}

{
  "error": "string"
}

GET

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

Parameters

masterchain_seqnointeger<int32>requiredpath

masterchain block seqno

Response

200OK

blockchain blocks

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/masterchain/{masterchain_seqno}/blocks

curl -X GET 'https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/blocks'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/blocks')
data = response.json()

{
  "blocks": [
    {
      "tx_quantity": 130,
      "value_flow": {
        "from_prev_blk": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "to_next_blk": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "imported": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "exported": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "fees_collected": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "burned": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "fees_imported": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "recovered": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "created": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        },
        "minted": {
          "grams": 10000000000,
          "other": [
            {
              "id": 13,
              "value": "10000000000"
            }
          ]
        }
      },
      "workchain_id": 0,
      "shard": 8000000000000000,
      "seqno": 21734019,
      "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
      "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB",
      "global_id": -239,
      "version": 0,
      "after_merge": true,
      "before_split": true,
      "after_split": true,
      "want_split": true,
      "want_merge": true,
      "key_block": true,
      "gen_utime": 1674826775,
      "start_lt": 23814011000000,
      "end_lt": 23814011000001,
      "vert_seqno": 0,
      "gen_catchain_seqno": 0,
      "min_ref_mc_seqno": 0,
      "prev_key_block_seqno": 0,
      "gen_software_version": 0,
      "gen_software_capabilities": 0,
      "master_ref": "(-1,4234234,8000000000000000)",
      "prev_refs": [
        [
          "(-1",
          4234235,
          "8000000000000000)"
        ]
      ],
      "in_msg_descr_length": 0,
      "out_msg_descr_length": 0,
      "rand_seed": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
      "created_by": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
    }
  ]
}

{
  "error": "string"
}

GET

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

Parameters

masterchain_seqnointeger<int32>requiredpath

masterchain block seqno

Response

200OK

blockchain transactions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/masterchain/{masterchain_seqno}/transactions

curl -X GET 'https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/transactions'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/transactions')
data = response.json()

{
  "transactions": [
    {
      "hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "lt": 25713146000001,
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "success": true,
      "utime": 1645544908,
      "orig_status": "active",
      "end_status": "active",
      "total_fees": 25713146000001,
      "end_balance": 25713146000001,
      "transaction_type": "TransOrd",
      "state_update_old": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "state_update_new": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "in_msg": {
        "msg_type": "int_msg",
        "created_lt": 25713146000001,
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "value": 60000000,
        "fwd_fee": 5681002,
        "ihr_fee": 5681002,
        "destination": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "source": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "import_fee": 5681002,
        "created_at": 5681002,
        "op_code": "0xdeadbeaf",
        "init": {
          "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
        },
        "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
        "decoded_op_name": "nft_transfer"
      },
      "out_msgs": [
        {
          "msg_type": "int_msg",
          "created_lt": 25713146000001,
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "value": 60000000,
          "fwd_fee": 5681002,
          "ihr_fee": 5681002,
          "destination": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "source": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "import_fee": 5681002,
          "created_at": 5681002,
          "op_code": "0xdeadbeaf",
          "init": {
            "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
          },
          "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
          "decoded_op_name": "nft_transfer"
        }
      ],
      "block": "(-1,4234234,8000000000000000)",
      "prev_trans_hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "prev_trans_lt": 25713146000001,
      "compute_phase": {
        "skipped": true,
        "skip_reason": "cskip_no_state",
        "success": true,
        "gas_fees": 1000,
        "gas_used": 10000,
        "vm_steps": 5,
        "exit_code": 0,
        "exit_code_description": "string"
      },
      "storage_phase": {
        "fees_collected": 25713146000001,
        "fees_due": 25713146000001,
        "status_change": "acst_unchanged"
      },
      "credit_phase": {
        "fees_collected": 100,
        "credit": 1000
      },
      "action_phase": {
        "success": true,
        "result_code": 5,
        "total_actions": 5,
        "skipped_actions": 5,
        "fwd_fees": 1000,
        "total_fees": 1000,
        "result_code_description": "string"
      },
      "bounce_phase": "cskip_no_state",
      "aborted": true,
      "destroyed": true
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config

Get blockchain config from a specific block, if present.

Parameters

masterchain_seqnointeger<int32>requiredpath

masterchain block seqno

Response

200OK

blockchain config

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/masterchain/{masterchain_seqno}/config

curl -X GET 'https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config')
data = response.json()

{
  "0": "string",
  "1": "string",
  "2": "string",
  "3": "string",
  "4": "string",
  "5": {
    "blackhole_addr": "string",
    "fee_burn_nom": 0,
    "fee_burn_denom": 0
  },
  "6": {
    "mint_new_price": 0,
    "mint_add_price": 0
  },
  "7": {
    "currencies": [
      {
        "currency_id": 0,
        "amount": "string"
      }
    ]
  },
  "8": {
    "version": 0,
    "capabilities": 0
  },
  "9": {
    "mandatory_params": [
      0
    ]
  },
  "10": {
    "critical_params": [
      0
    ]
  },
  "11": {
    "normal_params": {
      "min_tot_rounds": 2,
      "max_tot_rounds": 6,
      "min_wins": 2,
      "max_losses": 6,
      "min_store_sec": 1000000,
      "max_store_sec": 10000000,
      "bit_price": 1,
      "cell_price": 500
    },
    "critical_params": {
      "min_tot_rounds": 2,
      "max_tot_rounds": 6,
      "min_wins": 2,
      "max_losses": 6,
      "min_store_sec": 1000000,
      "max_store_sec": 10000000,
      "bit_price": 1,
      "cell_price": 500
    }
  },
  "12": {
    "workchains": [
      {
        "workchain": 0,
        "enabled_since": 1000000,
        "actual_min_split": 1000000,
        "min_split": 1000000,
        "max_split": 1000000,
        "basic": 1000000,
        "active": true,
        "accept_msgs": true,
        "flags": 1000000,
        "zerostate_root_hash": 1000000,
        "zerostate_file_hash": 1000000,
        "version": 1000000
      }
    ]
  },
  "13": {
    "deposit": 0,
    "bit_price": 0,
    "cell_price": 0
  },
  "14": {
    "masterchain_block_fee": 0,
    "basechain_block_fee": 0
  },
  "15": {
    "validators_elected_for": 65536,
    "elections_start_before": 32768,
    "elections_end_before": 8192,
    "stake_held_for": 32768
  },
  "16": {
    "max_validators": 400,
    "max_main_validators": 100,
    "min_validators": 75
  },
  "17": {
    "min_stake": "string",
    "max_stake": "string",
    "min_total_stake": "string",
    "max_stake_factor": 0
  },
  "18": {
    "storage_prices": [
      {
        "utime_since": 0,
        "bit_price_ps": 1,
        "cell_price_ps": 500,
        "mc_bit_price_ps": 1000,
        "mc_cell_price_ps": 500000
      }
    ]
  },
  "20": {
    "gas_limits_prices": {
      "special_gas_limit": 0,
      "flat_gas_limit": 0,
      "flat_gas_price": 0,
      "gas_price": 1,
      "gas_limit": 1000000,
      "gas_credit": 1000000,
      "block_gas_limit": 1000000,
      "freeze_due_limit": 1000000,
      "delete_due_limit": 1000000
    }
  },
  "21": {
    "gas_limits_prices": {
      "special_gas_limit": 0,
      "flat_gas_limit": 0,
      "flat_gas_price": 0,
      "gas_price": 1,
      "gas_limit": 1000000,
      "gas_credit": 1000000,
      "block_gas_limit": 1000000,
      "freeze_due_limit": 1000000,
      "delete_due_limit": 1000000
    }
  },
  "22": {
    "block_limits": {
      "bytes": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "gas": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "lt_delta": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      }
    }
  },
  "23": {
    "block_limits": {
      "bytes": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "gas": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "lt_delta": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      }
    }
  },
  "24": {
    "msg_forward_prices": {
      "lump_price": 1000000,
      "bit_price": 1000000,
      "cell_price": 1000000,
      "ihr_price_factor": 1000000,
      "first_frac": 1000000,
      "next_frac": 1000000
    }
  },
  "25": {
    "msg_forward_prices": {
      "lump_price": 1000000,
      "bit_price": 1000000,
      "cell_price": 1000000,
      "ihr_price_factor": 1000000,
      "first_frac": 1000000,
      "next_frac": 1000000
    }
  },
  "28": {
    "mc_catchain_lifetime": 1000000,
    "shard_catchain_lifetime": 1000000,
    "shard_validators_lifetime": 1000000,
    "shard_validators_num": 1000000,
    "flags": 1000000,
    "shuffle_mc_validators": true
  },
  "29": {
    "flags": 0,
    "new_catchain_ids": true,
    "round_candidates": 3,
    "next_candidate_delay_ms": 2000,
    "consensus_timeout_ms": 16000,
    "fast_attempts": 3,
    "attempt_duration": 8,
    "catchain_max_deps": 4,
    "max_block_bytes": 2097152,
    "max_collated_bytes": 2097152,
    "proto_version": 2,
    "catchain_max_blocks_coeff": 10000
  },
  "31": {
    "fundamental_smc_addr": [
      "-1:dd24c4a1f2b88f8b7053513b5cc6c5a31bc44b2a72dcb4d8c0338af0f0d37ec5"
    ]
  },
  "32": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "33": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "34": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "35": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "36": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "37": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "40": {
    "misbehaviour_punishment_config": {
      "default_flat_fine": 1000000,
      "default_proportional_fine": 1000000,
      "severity_flat_mult": 1000000,
      "severity_proportional_mult": 1000000,
      "unpunishable_interval": 1000000,
      "long_interval": 1000000,
      "long_flat_mult": 1000000,
      "long_proportional_mult": 1000000,
      "medium_interval": 1000000,
      "medium_flat_mult": 1000000,
      "medium_proportional_mult": 1000000
    }
  },
  "43": {
    "size_limits_config": {
      "max_msg_bits": 1000000,
      "max_msg_cells": 1000000,
      "max_library_cells": 1000000,
      "max_vm_data_depth": 1000000,
      "max_ext_msg_size": 1000000,
      "max_ext_msg_depth": 1000000,
      "max_acc_state_cells": 1000000,
      "max_acc_state_bits": 1000000
    }
  },
  "44": {
    "accounts": [
      "string"
    ],
    "suspended_until": 0
  },
  "71": {
    "oracle_bridge_params": {
      "bridge_addr": "string",
      "oracle_multisig_address": "string",
      "external_chain_address": "string",
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ]
    }
  },
  "72": {
    "oracle_bridge_params": {
      "bridge_addr": "string",
      "oracle_multisig_address": "string",
      "external_chain_address": "string",
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ]
    }
  },
  "73": {
    "oracle_bridge_params": {
      "bridge_addr": "string",
      "oracle_multisig_address": "string",
      "external_chain_address": "string",
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ]
    }
  },
  "79": {
    "jetton_bridge_params": {
      "bridge_address": "string",
      "oracles_address": "string",
      "state_flags": 0,
      "burn_bridge_fee": 0,
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ],
      "external_chain_address": "string",
      "prices": {
        "bridge_burn_fee": 0,
        "bridge_mint_fee": 0,
        "wallet_min_tons_for_storage": 0,
        "wallet_gas_consumption": 0,
        "minter_min_tons_for_storage": 0,
        "discover_gas_consumption": 0
      }
    }
  },
  "81": {
    "jetton_bridge_params": {
      "bridge_address": "string",
      "oracles_address": "string",
      "state_flags": 0,
      "burn_bridge_fee": 0,
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ],
      "external_chain_address": "string",
      "prices": {
        "bridge_burn_fee": 0,
        "bridge_mint_fee": 0,
        "wallet_min_tons_for_storage": 0,
        "wallet_gas_consumption": 0,
        "minter_min_tons_for_storage": 0,
        "discover_gas_consumption": 0
      }
    }
  },
  "82": {
    "jetton_bridge_params": {
      "bridge_address": "string",
      "oracles_address": "string",
      "state_flags": 0,
      "burn_bridge_fee": 0,
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ],
      "external_chain_address": "string",
      "prices": {
        "bridge_burn_fee": 0,
        "bridge_mint_fee": 0,
        "wallet_min_tons_for_storage": 0,
        "wallet_gas_consumption": 0,
        "minter_min_tons_for_storage": 0,
        "discover_gas_consumption": 0
      }
    }
  },
  "raw": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config/raw

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

Parameters

masterchain_seqnointeger<int32>requiredpath

masterchain block seqno

Response

200OK

blockchain config

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/masterchain/{masterchain_seqno}/config/raw

curl -X GET 'https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config/raw'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config/raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/masterchain/{masterchain_seqno}/config/raw')
data = response.json()

{
  "config": {}
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/blocks/{block_id}/transactions

Get transactions from block

Parameters

block_idstringrequiredpath

block ID

Response

200OK

blockchain block transactions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/blocks/{block_id}/transactions

curl -X GET 'https://ton.nownodes.io/v2/blockchain/blocks/{block_id}/transactions'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/blocks/{block_id}/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/blocks/{block_id}/transactions')
data = response.json()

{
  "transactions": [
    {
      "hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "lt": 25713146000001,
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "success": true,
      "utime": 1645544908,
      "orig_status": "active",
      "end_status": "active",
      "total_fees": 25713146000001,
      "end_balance": 25713146000001,
      "transaction_type": "TransOrd",
      "state_update_old": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "state_update_new": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "in_msg": {
        "msg_type": "int_msg",
        "created_lt": 25713146000001,
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "value": 60000000,
        "fwd_fee": 5681002,
        "ihr_fee": 5681002,
        "destination": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "source": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "import_fee": 5681002,
        "created_at": 5681002,
        "op_code": "0xdeadbeaf",
        "init": {
          "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
        },
        "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
        "decoded_op_name": "nft_transfer"
      },
      "out_msgs": [
        {
          "msg_type": "int_msg",
          "created_lt": 25713146000001,
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "value": 60000000,
          "fwd_fee": 5681002,
          "ihr_fee": 5681002,
          "destination": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "source": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "import_fee": 5681002,
          "created_at": 5681002,
          "op_code": "0xdeadbeaf",
          "init": {
            "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
          },
          "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
          "decoded_op_name": "nft_transfer"
        }
      ],
      "block": "(-1,4234234,8000000000000000)",
      "prev_trans_hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "prev_trans_lt": 25713146000001,
      "compute_phase": {
        "skipped": true,
        "skip_reason": "cskip_no_state",
        "success": true,
        "gas_fees": 1000,
        "gas_used": 10000,
        "vm_steps": 5,
        "exit_code": 0,
        "exit_code_description": "string"
      },
      "storage_phase": {
        "fees_collected": 25713146000001,
        "fees_due": 25713146000001,
        "status_change": "acst_unchanged"
      },
      "credit_phase": {
        "fees_collected": 100,
        "credit": 1000
      },
      "action_phase": {
        "success": true,
        "result_code": 5,
        "total_actions": 5,
        "skipped_actions": 5,
        "fwd_fees": 1000,
        "total_fees": 1000,
        "result_code_description": "string"
      },
      "bounce_phase": "cskip_no_state",
      "aborted": true,
      "destroyed": true
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/transactions/{transaction_id}

Get transaction data

Parameters

transaction_idstringrequiredpath

transaction ID

Response

200OK

blockchain transaction

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/transactions/{transaction_id}

curl -X GET 'https://ton.nownodes.io/v2/blockchain/transactions/{transaction_id}'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/transactions/{transaction_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/transactions/{transaction_id}')
data = response.json()

{
  "hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "lt": 25713146000001,
  "account": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "success": true,
  "utime": 1645544908,
  "orig_status": "active",
  "end_status": "active",
  "total_fees": 25713146000001,
  "end_balance": 25713146000001,
  "transaction_type": "TransOrd",
  "state_update_old": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "state_update_new": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "in_msg": {
    "msg_type": "int_msg",
    "created_lt": 25713146000001,
    "ihr_disabled": true,
    "bounce": true,
    "bounced": true,
    "value": 60000000,
    "fwd_fee": 5681002,
    "ihr_fee": 5681002,
    "destination": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "source": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "import_fee": 5681002,
    "created_at": 5681002,
    "op_code": "0xdeadbeaf",
    "init": {
      "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
    },
    "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
    "decoded_op_name": "nft_transfer"
  },
  "out_msgs": [
    {
      "msg_type": "int_msg",
      "created_lt": 25713146000001,
      "ihr_disabled": true,
      "bounce": true,
      "bounced": true,
      "value": 60000000,
      "fwd_fee": 5681002,
      "ihr_fee": 5681002,
      "destination": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "source": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "import_fee": 5681002,
      "created_at": 5681002,
      "op_code": "0xdeadbeaf",
      "init": {
        "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
      },
      "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
      "decoded_op_name": "nft_transfer"
    }
  ],
  "block": "(-1,4234234,8000000000000000)",
  "prev_trans_hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "prev_trans_lt": 25713146000001,
  "compute_phase": {
    "skipped": true,
    "skip_reason": "cskip_no_state",
    "success": true,
    "gas_fees": 1000,
    "gas_used": 10000,
    "vm_steps": 5,
    "exit_code": 0,
    "exit_code_description": "string"
  },
  "storage_phase": {
    "fees_collected": 25713146000001,
    "fees_due": 25713146000001,
    "status_change": "acst_unchanged"
  },
  "credit_phase": {
    "fees_collected": 100,
    "credit": 1000
  },
  "action_phase": {
    "success": true,
    "result_code": 5,
    "total_actions": 5,
    "skipped_actions": 5,
    "fwd_fees": 1000,
    "total_fees": 1000,
    "result_code_description": "string"
  },
  "bounce_phase": "cskip_no_state",
  "aborted": true,
  "destroyed": true
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/messages/{msg_id}/transaction

Get transaction data by message hash

Parameters

msg_idstringrequiredpath

message ID

Response

200OK

transaction by message hash

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/messages/{msg_id}/transaction

curl -X GET 'https://ton.nownodes.io/v2/blockchain/messages/{msg_id}/transaction'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/messages/{msg_id}/transaction', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/messages/{msg_id}/transaction')
data = response.json()

{
  "hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "lt": 25713146000001,
  "account": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "success": true,
  "utime": 1645544908,
  "orig_status": "active",
  "end_status": "active",
  "total_fees": 25713146000001,
  "end_balance": 25713146000001,
  "transaction_type": "TransOrd",
  "state_update_old": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "state_update_new": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "in_msg": {
    "msg_type": "int_msg",
    "created_lt": 25713146000001,
    "ihr_disabled": true,
    "bounce": true,
    "bounced": true,
    "value": 60000000,
    "fwd_fee": 5681002,
    "ihr_fee": 5681002,
    "destination": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "source": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "import_fee": 5681002,
    "created_at": 5681002,
    "op_code": "0xdeadbeaf",
    "init": {
      "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
    },
    "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
    "decoded_op_name": "nft_transfer"
  },
  "out_msgs": [
    {
      "msg_type": "int_msg",
      "created_lt": 25713146000001,
      "ihr_disabled": true,
      "bounce": true,
      "bounced": true,
      "value": 60000000,
      "fwd_fee": 5681002,
      "ihr_fee": 5681002,
      "destination": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "source": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "import_fee": 5681002,
      "created_at": 5681002,
      "op_code": "0xdeadbeaf",
      "init": {
        "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
      },
      "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
      "decoded_op_name": "nft_transfer"
    }
  ],
  "block": "(-1,4234234,8000000000000000)",
  "prev_trans_hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
  "prev_trans_lt": 25713146000001,
  "compute_phase": {
    "skipped": true,
    "skip_reason": "cskip_no_state",
    "success": true,
    "gas_fees": 1000,
    "gas_used": 10000,
    "vm_steps": 5,
    "exit_code": 0,
    "exit_code_description": "string"
  },
  "storage_phase": {
    "fees_collected": 25713146000001,
    "fees_due": 25713146000001,
    "status_change": "acst_unchanged"
  },
  "credit_phase": {
    "fees_collected": 100,
    "credit": 1000
  },
  "action_phase": {
    "success": true,
    "result_code": 5,
    "total_actions": 5,
    "skipped_actions": 5,
    "fwd_fees": 1000,
    "total_fees": 1000,
    "result_code_description": "string"
  },
  "bounce_phase": "cskip_no_state",
  "aborted": true,
  "destroyed": true
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/validators

Get blockchain validators

Response

200OK

blockchain validators

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/validators

curl -X GET 'https://ton.nownodes.io/v2/blockchain/validators'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/validators')
data = response.json()

{
  "elect_at": 123456789,
  "elect_close": 123456789,
  "min_stake": 123456789,
  "total_stake": 123456789,
  "validators": [
    {
      "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "adnl_address": "10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "stake": 123456789,
      "max_factor": 123456789
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/masterchain-head

Get last known masterchain block

Response

200OK

blockchain masterchain head

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/masterchain-head

curl -X GET 'https://ton.nownodes.io/v2/blockchain/masterchain-head'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/masterchain-head', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/masterchain-head')
data = response.json()

{
  "tx_quantity": 130,
  "value_flow": {
    "from_prev_blk": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "to_next_blk": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "imported": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "exported": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "fees_collected": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "burned": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "fees_imported": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "recovered": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "created": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    },
    "minted": {
      "grams": 10000000000,
      "other": [
        {
          "id": 13,
          "value": "10000000000"
        }
      ]
    }
  },
  "workchain_id": 0,
  "shard": 8000000000000000,
  "seqno": 21734019,
  "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB",
  "global_id": -239,
  "version": 0,
  "after_merge": true,
  "before_split": true,
  "after_split": true,
  "want_split": true,
  "want_merge": true,
  "key_block": true,
  "gen_utime": 1674826775,
  "start_lt": 23814011000000,
  "end_lt": 23814011000001,
  "vert_seqno": 0,
  "gen_catchain_seqno": 0,
  "min_ref_mc_seqno": 0,
  "prev_key_block_seqno": 0,
  "gen_software_version": 0,
  "gen_software_capabilities": 0,
  "master_ref": "(-1,4234234,8000000000000000)",
  "prev_refs": [
    [
      "(-1",
      4234235,
      "8000000000000000)"
    ]
  ],
  "in_msg_descr_length": 0,
  "out_msg_descr_length": 0,
  "rand_seed": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "created_by": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/accounts/{account_id}

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

Parameters

account_idstringrequiredpath

account ID

Response

200OK

raw account

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/accounts/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/blockchain/accounts/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}')
data = response.json()

{
  "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
  "balance": 123456789,
  "extra_balance": {},
  "code": "b5ee9c72410104010087000114ff00f4a413f4a0f2c80b0102012002030002d200dfa5ffff76a268698fe9ffe8e42c5267858f90e785ffe4f6aa6467c444ffb365ffc10802faf0807d014035e7a064b87d804077e7857fc10803dfd2407d014035e7a064b86467cd8903a32b9ba4410803ade68afd014035e7a045ea432b6363796103bb7b9363210c678b64b87d807d8040c249b3e4",
  "data": "b5ee9c7241010101002600004811fd096c0000000000000000000000000000000000000000000000000000000000000000cb78264d",
  "last_transaction_lt": 123456789,
  "last_transaction_hash": "088b436a846d92281734236967970612f87fbd64a2cd3573107948379e8e4161",
  "frozen_hash": "088b436a846d92281734236967970612f87fbd64a2cd3573107948379e8e4161",
  "status": "active",
  "storage": {
    "used_cells": 567,
    "used_bits": 567,
    "used_public_cells": 567,
    "last_paid": 567,
    "due_payment": 567
  },
  "libraries": [
    {
      "public": true,
      "root": "string"
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/transactions

Get account transactions

Parameters

account_idstringrequiredpath

account ID

after_ltinteger<int64>query

omit this parameter to get last transactions

before_ltinteger<int64>query

omit this parameter to get last transactions

limitinteger<int32>[1, 1000]100query

Response

200OK

blockchain account transactions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/accounts/{account_id}/transactions

curl -X GET 'https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/transactions'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/transactions')
data = response.json()

{
  "transactions": [
    {
      "hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "lt": 25713146000001,
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "success": true,
      "utime": 1645544908,
      "orig_status": "active",
      "end_status": "active",
      "total_fees": 25713146000001,
      "end_balance": 25713146000001,
      "transaction_type": "TransOrd",
      "state_update_old": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "state_update_new": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "in_msg": {
        "msg_type": "int_msg",
        "created_lt": 25713146000001,
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "value": 60000000,
        "fwd_fee": 5681002,
        "ihr_fee": 5681002,
        "destination": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "source": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "import_fee": 5681002,
        "created_at": 5681002,
        "op_code": "0xdeadbeaf",
        "init": {
          "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
        },
        "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
        "decoded_op_name": "nft_transfer"
      },
      "out_msgs": [
        {
          "msg_type": "int_msg",
          "created_lt": 25713146000001,
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "value": 60000000,
          "fwd_fee": 5681002,
          "ihr_fee": 5681002,
          "destination": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "source": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "import_fee": 5681002,
          "created_at": 5681002,
          "op_code": "0xdeadbeaf",
          "init": {
            "boc": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
          },
          "raw_body": "B5EE9C7201010101001100001D00048656C6C6F2C20776F726C64218",
          "decoded_op_name": "nft_transfer"
        }
      ],
      "block": "(-1,4234234,8000000000000000)",
      "prev_trans_hash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "prev_trans_lt": 25713146000001,
      "compute_phase": {
        "skipped": true,
        "skip_reason": "cskip_no_state",
        "success": true,
        "gas_fees": 1000,
        "gas_used": 10000,
        "vm_steps": 5,
        "exit_code": 0,
        "exit_code_description": "string"
      },
      "storage_phase": {
        "fees_collected": 25713146000001,
        "fees_due": 25713146000001,
        "status_change": "acst_unchanged"
      },
      "credit_phase": {
        "fees_collected": 100,
        "credit": 1000
      },
      "action_phase": {
        "success": true,
        "result_code": 5,
        "total_actions": 5,
        "skipped_actions": 5,
        "fwd_fees": 1000,
        "total_fees": 1000,
        "result_code_description": "string"
      },
      "bounce_phase": "cskip_no_state",
      "aborted": true,
      "destroyed": true
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/methods/{method_name}

Execute get method for account

Parameters

account_idstringrequiredpath

account ID

method_namestringrequiredpath

contract get method name

argsArray<string>query

Response

200OK

method execution result

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/accounts/{account_id}/methods/{method_name}

curl -X GET 'https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/methods/{method_name}'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/methods/{method_name}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/methods/{method_name}')
data = response.json()

default

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/blockchain/message

Send message to blockchain

Body

application/json

both a single boc and a batch of boc serialized in base64 are accepted

bocstring

batchArray<string>

Response

200OK

the message has been sent

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/blockchain/message

curl -X POST 'https://ton.nownodes.io/v2/blockchain/message' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
    "batch": [
      "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
    ]
  }'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
      "batch": [
        "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
  "batch": [
    "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  ]
}

response = requests.post('https://ton.nownodes.io/v2/blockchain/message', json=payload)
data = response.json()

Request Body

{
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
  "batch": [
    "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  ]
}

default

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/config

Get blockchain config

Response

200OK

blockchain config

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/config

curl -X GET 'https://ton.nownodes.io/v2/blockchain/config'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/config', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/config')
data = response.json()

{
  "0": "string",
  "1": "string",
  "2": "string",
  "3": "string",
  "4": "string",
  "5": {
    "blackhole_addr": "string",
    "fee_burn_nom": 0,
    "fee_burn_denom": 0
  },
  "6": {
    "mint_new_price": 0,
    "mint_add_price": 0
  },
  "7": {
    "currencies": [
      {
        "currency_id": 0,
        "amount": "string"
      }
    ]
  },
  "8": {
    "version": 0,
    "capabilities": 0
  },
  "9": {
    "mandatory_params": [
      0
    ]
  },
  "10": {
    "critical_params": [
      0
    ]
  },
  "11": {
    "normal_params": {
      "min_tot_rounds": 2,
      "max_tot_rounds": 6,
      "min_wins": 2,
      "max_losses": 6,
      "min_store_sec": 1000000,
      "max_store_sec": 10000000,
      "bit_price": 1,
      "cell_price": 500
    },
    "critical_params": {
      "min_tot_rounds": 2,
      "max_tot_rounds": 6,
      "min_wins": 2,
      "max_losses": 6,
      "min_store_sec": 1000000,
      "max_store_sec": 10000000,
      "bit_price": 1,
      "cell_price": 500
    }
  },
  "12": {
    "workchains": [
      {
        "workchain": 0,
        "enabled_since": 1000000,
        "actual_min_split": 1000000,
        "min_split": 1000000,
        "max_split": 1000000,
        "basic": 1000000,
        "active": true,
        "accept_msgs": true,
        "flags": 1000000,
        "zerostate_root_hash": 1000000,
        "zerostate_file_hash": 1000000,
        "version": 1000000
      }
    ]
  },
  "13": {
    "deposit": 0,
    "bit_price": 0,
    "cell_price": 0
  },
  "14": {
    "masterchain_block_fee": 0,
    "basechain_block_fee": 0
  },
  "15": {
    "validators_elected_for": 65536,
    "elections_start_before": 32768,
    "elections_end_before": 8192,
    "stake_held_for": 32768
  },
  "16": {
    "max_validators": 400,
    "max_main_validators": 100,
    "min_validators": 75
  },
  "17": {
    "min_stake": "string",
    "max_stake": "string",
    "min_total_stake": "string",
    "max_stake_factor": 0
  },
  "18": {
    "storage_prices": [
      {
        "utime_since": 0,
        "bit_price_ps": 1,
        "cell_price_ps": 500,
        "mc_bit_price_ps": 1000,
        "mc_cell_price_ps": 500000
      }
    ]
  },
  "20": {
    "gas_limits_prices": {
      "special_gas_limit": 0,
      "flat_gas_limit": 0,
      "flat_gas_price": 0,
      "gas_price": 1,
      "gas_limit": 1000000,
      "gas_credit": 1000000,
      "block_gas_limit": 1000000,
      "freeze_due_limit": 1000000,
      "delete_due_limit": 1000000
    }
  },
  "21": {
    "gas_limits_prices": {
      "special_gas_limit": 0,
      "flat_gas_limit": 0,
      "flat_gas_price": 0,
      "gas_price": 1,
      "gas_limit": 1000000,
      "gas_credit": 1000000,
      "block_gas_limit": 1000000,
      "freeze_due_limit": 1000000,
      "delete_due_limit": 1000000
    }
  },
  "22": {
    "block_limits": {
      "bytes": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "gas": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "lt_delta": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      }
    }
  },
  "23": {
    "block_limits": {
      "bytes": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "gas": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      },
      "lt_delta": {
        "underload": 1000000,
        "soft_limit": 1000000,
        "hard_limit": 1000000
      }
    }
  },
  "24": {
    "msg_forward_prices": {
      "lump_price": 1000000,
      "bit_price": 1000000,
      "cell_price": 1000000,
      "ihr_price_factor": 1000000,
      "first_frac": 1000000,
      "next_frac": 1000000
    }
  },
  "25": {
    "msg_forward_prices": {
      "lump_price": 1000000,
      "bit_price": 1000000,
      "cell_price": 1000000,
      "ihr_price_factor": 1000000,
      "first_frac": 1000000,
      "next_frac": 1000000
    }
  },
  "28": {
    "mc_catchain_lifetime": 1000000,
    "shard_catchain_lifetime": 1000000,
    "shard_validators_lifetime": 1000000,
    "shard_validators_num": 1000000,
    "flags": 1000000,
    "shuffle_mc_validators": true
  },
  "29": {
    "flags": 0,
    "new_catchain_ids": true,
    "round_candidates": 3,
    "next_candidate_delay_ms": 2000,
    "consensus_timeout_ms": 16000,
    "fast_attempts": 3,
    "attempt_duration": 8,
    "catchain_max_deps": 4,
    "max_block_bytes": 2097152,
    "max_collated_bytes": 2097152,
    "proto_version": 2,
    "catchain_max_blocks_coeff": 10000
  },
  "31": {
    "fundamental_smc_addr": [
      "-1:dd24c4a1f2b88f8b7053513b5cc6c5a31bc44b2a72dcb4d8c0338af0f0d37ec5"
    ]
  },
  "32": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "33": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "34": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "35": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "36": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "37": {
    "utime_since": 0,
    "utime_until": 0,
    "total": 0,
    "main": 0,
    "total_weight": "1152921504606846800",
    "list": [
      {
        "public_key": "string",
        "weight": 0,
        "adnl_addr": "string"
      }
    ]
  },
  "40": {
    "misbehaviour_punishment_config": {
      "default_flat_fine": 1000000,
      "default_proportional_fine": 1000000,
      "severity_flat_mult": 1000000,
      "severity_proportional_mult": 1000000,
      "unpunishable_interval": 1000000,
      "long_interval": 1000000,
      "long_flat_mult": 1000000,
      "long_proportional_mult": 1000000,
      "medium_interval": 1000000,
      "medium_flat_mult": 1000000,
      "medium_proportional_mult": 1000000
    }
  },
  "43": {
    "size_limits_config": {
      "max_msg_bits": 1000000,
      "max_msg_cells": 1000000,
      "max_library_cells": 1000000,
      "max_vm_data_depth": 1000000,
      "max_ext_msg_size": 1000000,
      "max_ext_msg_depth": 1000000,
      "max_acc_state_cells": 1000000,
      "max_acc_state_bits": 1000000
    }
  },
  "44": {
    "accounts": [
      "string"
    ],
    "suspended_until": 0
  },
  "71": {
    "oracle_bridge_params": {
      "bridge_addr": "string",
      "oracle_multisig_address": "string",
      "external_chain_address": "string",
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ]
    }
  },
  "72": {
    "oracle_bridge_params": {
      "bridge_addr": "string",
      "oracle_multisig_address": "string",
      "external_chain_address": "string",
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ]
    }
  },
  "73": {
    "oracle_bridge_params": {
      "bridge_addr": "string",
      "oracle_multisig_address": "string",
      "external_chain_address": "string",
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ]
    }
  },
  "79": {
    "jetton_bridge_params": {
      "bridge_address": "string",
      "oracles_address": "string",
      "state_flags": 0,
      "burn_bridge_fee": 0,
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ],
      "external_chain_address": "string",
      "prices": {
        "bridge_burn_fee": 0,
        "bridge_mint_fee": 0,
        "wallet_min_tons_for_storage": 0,
        "wallet_gas_consumption": 0,
        "minter_min_tons_for_storage": 0,
        "discover_gas_consumption": 0
      }
    }
  },
  "81": {
    "jetton_bridge_params": {
      "bridge_address": "string",
      "oracles_address": "string",
      "state_flags": 0,
      "burn_bridge_fee": 0,
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ],
      "external_chain_address": "string",
      "prices": {
        "bridge_burn_fee": 0,
        "bridge_mint_fee": 0,
        "wallet_min_tons_for_storage": 0,
        "wallet_gas_consumption": 0,
        "minter_min_tons_for_storage": 0,
        "discover_gas_consumption": 0
      }
    }
  },
  "82": {
    "jetton_bridge_params": {
      "bridge_address": "string",
      "oracles_address": "string",
      "state_flags": 0,
      "burn_bridge_fee": 0,
      "oracles": [
        {
          "address": "0:55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
          "secp_pubkey": "00000000000000000000000017dcab1b1481610f6c7a7a98cf0370dc0ec704a6"
        }
      ],
      "external_chain_address": "string",
      "prices": {
        "bridge_burn_fee": 0,
        "bridge_mint_fee": 0,
        "wallet_min_tons_for_storage": 0,
        "wallet_gas_consumption": 0,
        "minter_min_tons_for_storage": 0,
        "discover_gas_consumption": 0
      }
    }
  },
  "raw": "te6ccgEBBgEARAABFP8A9KQT9LzyyAsBAgEgAgMCAUgEBQAE8jAAONBsIdMfMO1E0NM/MAHAAZekyMs/ye1UkzDyBuIAEaE0MdqJoaZ+YQ=="
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/config/raw

Get raw blockchain config

Response

200OK

blockchain config

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/config/raw

curl -X GET 'https://ton.nownodes.io/v2/blockchain/config/raw'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/config/raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/config/raw')
data = response.json()

{
  "config": {}
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/inspect

Blockchain account inspect

Parameters

account_idstringrequiredpath

account ID

Response

200OK

blockchain account inspect

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/blockchain/accounts/{account_id}/inspect

curl -X GET 'https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/inspect'

const response = await fetch('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/inspect', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/blockchain/accounts/{account_id}/inspect')
data = response.json()

{
  "code": "string",
  "code_hash": "string",
  "methods": [
    {
      "id": 0,
      "method": "get_something"
    }
  ],
  "compiler": "func"
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/message/decode

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

Body

application/json

bag-of-cells serialized to base64

bocstringrequired

Response

200OK

decoded message

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/message/decode

curl -X POST 'https://ton.nownodes.io/v2/message/decode' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  }'

const response = await fetch('https://ton.nownodes.io/v2/message/decode', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

response = requests.post('https://ton.nownodes.io/v2/message/decode', json=payload)
data = response.json()

Request Body

{
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

{
  "destination": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "destination_wallet_version": "v3R2",
  "ext_in_msg_decoded": {
    "wallet_v3": {
      "subwallet_id": 1,
      "valid_until": 1,
      "seqno": 1,
      "raw_messages": [
        {
          "message": {
            "boc": "te6ccgEBAQEABgAACCiAmCMBAgEABwA=",
            "decoded_op_name": "nft_transfer",
            "op_code": "0xdeadbeaf"
          },
          "mode": 2
        }
      ]
    },
    "wallet_v4": {
      "subwallet_id": 1,
      "valid_until": 1,
      "seqno": 1,
      "op": 1,
      "raw_messages": [
        {
          "message": {
            "boc": "te6ccgEBAQEABgAACCiAmCMBAgEABwA=",
            "decoded_op_name": "nft_transfer",
            "op_code": "0xdeadbeaf"
          },
          "mode": 2
        }
      ]
    },
    "wallet_highload_v2": {
      "subwallet_id": 1,
      "bounded_query_id": "34254528475294857",
      "raw_messages": [
        {
          "message": {
            "boc": "te6ccgEBAQEABgAACCiAmCMBAgEABwA=",
            "decoded_op_name": "nft_transfer",
            "op_code": "0xdeadbeaf"
          },
          "mode": 2
        }
      ]
    }
  }
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/address/{account_id}/parse

parse address and display in all formats

Parameters

account_idstringrequiredpath

account ID

Response

200OK

all forms and info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/address/{account_id}/parse

curl -X GET 'https://ton.nownodes.io/v2/address/{account_id}/parse'

const response = await fetch('https://ton.nownodes.io/v2/address/{account_id}/parse', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/address/{account_id}/parse')
data = response.json()

{
  "raw_form": "0:6e731f2e28b73539a7f85ac47ca104d5840b229351189977bb6151d36b5e3f5e",
  "bounceable": {
    "b64": "string",
    "b64url": "string"
  },
  "non_bounceable": {
    "b64": "string",
    "b64url": "string"
  },
  "given_type": "string",
  "test_only": true
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/events/emulate

Emulate sending message to blockchain

Body

application/json

bag-of-cells serialized to base64

bocstringrequired

Parameters

Accept-Languagestringenheader

ignore_signature_checkbooleanquery

Response

200OK

emulated event

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/events/emulate

curl -X POST 'https://ton.nownodes.io/v2/events/emulate' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  }'

const response = await fetch('https://ton.nownodes.io/v2/events/emulate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

response = requests.post('https://ton.nownodes.io/v2/events/emulate', json=payload)
data = response.json()

Request Body

{
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "timestamp": 1234567890,
  "actions": [
    {
      "type": "TonTransfer",
      "status": "ok",
      "TonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 123456789,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "ContractDeploy": {
        "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "interfaces": [
          "nft_item",
          "nft_royalty"
        ]
      },
      "JettonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        },
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonBurn": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "NftItemTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "nft": "",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "payload": "0234de3e21d21b3ee21f3",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "Subscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 1000000000,
        "initial": false
      },
      "UnSubscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "AuctionBid": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "bidder": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "auction": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "NftPurchase": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "seller": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "buyer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "DepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStakeRequest": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "ElectionsDepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "ElectionsRecoverStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "JettonSwap": {
        "dex": "stonfi",
        "amount_in": "1660050553",
        "amount_out": "1660050553",
        "ton_in": 1000000000,
        "ton_out": 2000000000,
        "user_wallet": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "router": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "jetton_master_in": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        },
        "jetton_master_out": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "SmartContractExec": {
        "executor": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "contract": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "ton_attached": 123456789,
        "operation": "NftTransfer or 0x35d95a12",
        "payload": "string",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "DomainRenew": {
        "domain": "vasya.ton",
        "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "renewer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "InscriptionTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "InscriptionMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "simple_preview": {
        "name": "Ton Transfer",
        "description": "Transferring 5 Ton",
        "action_image": "string",
        "value": "5 Ton",
        "value_image": "string",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          }
        ]
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "value_flow": [
    {
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "ton": 80,
      "fees": 10,
      "jettons": [
        {
          "account": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "jetton": {
            "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
            "name": "Wrapped TON",
            "symbol": "WTON",
            "decimals": 9,
            "image": "https://cache.tonapi.io/images/jetton.jpg",
            "verification": "whitelist"
          },
          "quantity": 10
        }
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/traces/emulate

Emulate sending message to blockchain

Body

application/json

bag-of-cells serialized to base64

bocstringrequired

Parameters

ignore_signature_checkbooleanquery

Response

200OK

emulated trace

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/traces/emulate

curl -X POST 'https://ton.nownodes.io/v2/traces/emulate' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  }'

const response = await fetch('https://ton.nownodes.io/v2/traces/emulate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

response = requests.post('https://ton.nownodes.io/v2/traces/emulate', json=payload)
data = response.json()

Request Body

{
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

default

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/wallet/emulate

Emulate sending message to blockchain

Body

application/json

bag-of-cells serialized to base64 and additional parameters to configure emulation

bocstringrequired

paramsArray<object>

additional per account configuration

Show child attributes

addressstringrequired

balanceinteger<int64>

Parameters

Accept-Languagestringenheader

Response

200OK

emulated message

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/wallet/emulate

curl -X POST 'https://ton.nownodes.io/v2/wallet/emulate' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
    "params": [
      {
        "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
        "balance": 10000000000
      }
    ]
  }'

const response = await fetch('https://ton.nownodes.io/v2/wallet/emulate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
      "params": [
        {
          "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
          "balance": 10000000000
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
  "params": [
    {
      "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
      "balance": 10000000000
    }
  ]
}

response = requests.post('https://ton.nownodes.io/v2/wallet/emulate', json=payload)
data = response.json()

Request Body

{
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg",
  "params": [
    {
      "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
      "balance": 10000000000
    }
  ]
}

default

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/accounts/{account_id}/events/emulate

Emulate sending message to blockchain

Body

application/json

bag-of-cells serialized to base64

bocstringrequired

Parameters

Accept-Languagestringenheader

account_idstringrequiredpath

account ID

ignore_signature_checkbooleanquery

Response

200OK

emulated message to account

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/accounts/{account_id}/events/emulate

curl -X POST 'https://ton.nownodes.io/v2/accounts/{account_id}/events/emulate' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  }'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/events/emulate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

response = requests.post('https://ton.nownodes.io/v2/accounts/{account_id}/events/emulate', json=payload)
data = response.json()

Request Body

{
  "boc": "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
}

{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "account": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "timestamp": 1234567890,
  "actions": [
    {
      "type": "TonTransfer",
      "status": "ok",
      "TonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 123456789,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "ContractDeploy": {
        "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "interfaces": [
          "nft_item",
          "nft_royalty"
        ]
      },
      "JettonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        },
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonBurn": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "NftItemTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "nft": "",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "payload": "0234de3e21d21b3ee21f3",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "Subscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 1000000000,
        "initial": false
      },
      "UnSubscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "AuctionBid": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "bidder": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "auction": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "NftPurchase": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "seller": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "buyer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "DepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStakeRequest": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "ElectionsDepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "ElectionsRecoverStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "JettonSwap": {
        "dex": "stonfi",
        "amount_in": "1660050553",
        "amount_out": "1660050553",
        "ton_in": 1000000000,
        "ton_out": 2000000000,
        "user_wallet": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "router": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "jetton_master_in": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        },
        "jetton_master_out": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "SmartContractExec": {
        "executor": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "contract": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "ton_attached": 123456789,
        "operation": "NftTransfer or 0x35d95a12",
        "payload": "string",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "DomainRenew": {
        "domain": "vasya.ton",
        "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "renewer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "InscriptionTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "InscriptionMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "simple_preview": {
        "name": "Ton Transfer",
        "description": "Transferring 5 Ton",
        "action_image": "string",
        "value": "5 Ton",
        "value_image": "string",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          }
        ]
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false,
  "extra": 3
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/accounts/_bulk

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

Body

application/json

a list of account ids

account_idsArray<string>required

Response

200OK

a list of accounts

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/accounts/_bulk

curl -X POST 'https://ton.nownodes.io/v2/accounts/_bulk' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_ids": [
      "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
    ]
  }'

const response = await fetch('https://ton.nownodes.io/v2/accounts/_bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_ids": [
        "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "account_ids": [
    "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
  ]
}

response = requests.post('https://ton.nownodes.io/v2/accounts/_bulk', json=payload)
data = response.json()

Request Body

{
  "account_ids": [
    "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
  ]
}

{
  "accounts": [
    {
      "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
      "balance": 123456789,
      "last_activity": 123456789,
      "status": "active",
      "interfaces": [
        "nft_sale"
      ],
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "memo_required": true,
      "get_methods": [
        "get_item_data"
      ],
      "is_suspended": true,
      "is_wallet": true
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}

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

Parameters

account_idstringrequiredpath

account ID

Response

200OK

account

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}')
data = response.json()

{
  "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
  "balance": 123456789,
  "last_activity": 123456789,
  "status": "active",
  "interfaces": [
    "nft_sale"
  ],
  "name": "Ton foundation",
  "is_scam": true,
  "icon": "https://ton.org/logo.png",
  "memo_required": true,
  "get_methods": [
    "get_item_data"
  ],
  "is_suspended": true,
  "is_wallet": true
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/dns/backresolve

Get account's domains

Parameters

account_idstringrequiredpath

account ID

Response

200OK

account's domains

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/dns/backresolve

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/dns/backresolve'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/dns/backresolve', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/dns/backresolve')
data = response.json()

{
  "domains": [
    "vasya.ton"
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/jettons

Get all Jettons balances by owner address

Parameters

account_idstringrequiredpath

account ID

currenciesArray<string>query

accept ton and all possible fiat currencies, separated by commas

Response

200OK

account jettons balances

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/jettons

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/jettons'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/jettons', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/jettons')
data = response.json()

{
  "balances": [
    {
      "balance": 597968399,
      "price": {
        "prices": {
          "TON": 1.3710752873163712
        },
        "diff_24h": {
          "TON": "-1.28%"
        },
        "diff_7d": {
          "TON": "-2.74%"
        },
        "diff_30d": {
          "TON": "-0.56%"
        }
      },
      "wallet_address": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "jetton": {
        "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
        "name": "Wrapped TON",
        "symbol": "WTON",
        "decimals": 9,
        "image": "https://cache.tonapi.io/images/jetton.jpg",
        "verification": "whitelist"
      },
      "lock": {
        "amount": 597968399,
        "till": 1678223064
      }
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/jettons/history

Get the transfer jettons history for account

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 1000]requiredquery

start_dateinteger<int64>query

end_dateinteger<int64>query

Response

200OK

account jettons history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/jettons/history

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/jettons/history'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/jettons/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/jettons/history')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/jettons/{jetton_id}/history

Get the transfer jetton history for account and jetton

Parameters

account_idstringrequiredpath

account ID

jetton_idstringrequiredpath

jetton ID

Accept-Languagestringenheader

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 1000]requiredquery

start_dateinteger<int64>query

end_dateinteger<int64>query

Response

200OK

account jetton history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/jettons/{jetton_id}/history

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/jettons/{jetton_id}/history'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/jettons/{jetton_id}/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/jettons/{jetton_id}/history')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/nfts

Get all NFT items by owner address

Parameters

account_idstringrequiredpath

account ID

collectionstringquery

nft collection

limitinteger[1, 1000]1000query

offsetinteger>= 00query

indirect_ownershipbooleanfalsequery

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

Response

200OK

account nft items

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/nfts

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/nfts'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/nfts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/nfts')
data = response.json()

{
  "nft_items": [
    {
      "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
      "index": 58,
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "collection": {
        "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "name": "TON Diamonds",
        "description": "Best collection in TON network"
      },
      "verified": true,
      "metadata": {},
      "sale": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "market": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "owner": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "price": {
          "value": 123000000000,
          "token_name": "TON"
        }
      },
      "previews": [
        {
          "resolution": "100x100",
          "url": "https://site.com/pic1.jpg"
        }
      ],
      "dns": "crypto.ton",
      "approved_by": [
        "getgems"
      ]
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/nfts/history

Get the transfer nft history

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 1000]requiredquery

start_dateinteger<int64>query

end_dateinteger<int64>query

Response

200OK

nft history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/nfts/history

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/nfts/history'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/nfts/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/nfts/history')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/events

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.

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

initiatorbooleanfalsequery

Show only events that are initiated by this account

subject_onlybooleanfalsequery

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

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 100]requiredquery

start_dateinteger<int64>query

end_dateinteger<int64>query

Response

200OK

account's events

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/events

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/events'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/events')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/events/{event_id}

Get event for an account by event_id

Parameters

account_idstringrequiredpath

account ID

event_idstringrequiredpath

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

Accept-Languagestringenheader

subject_onlybooleanfalsequery

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

Response

200OK

account's event

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/events/{event_id}

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/events/{event_id}'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/events/{event_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/events/{event_id}')
data = response.json()

{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "account": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "timestamp": 1234567890,
  "actions": [
    {
      "type": "TonTransfer",
      "status": "ok",
      "TonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 123456789,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "ContractDeploy": {
        "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "interfaces": [
          "nft_item",
          "nft_royalty"
        ]
      },
      "JettonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        },
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonBurn": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "NftItemTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "nft": "",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "payload": "0234de3e21d21b3ee21f3",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "Subscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 1000000000,
        "initial": false
      },
      "UnSubscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "AuctionBid": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "bidder": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "auction": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "NftPurchase": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "seller": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "buyer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "DepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStakeRequest": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "ElectionsDepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "ElectionsRecoverStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "JettonSwap": {
        "dex": "stonfi",
        "amount_in": "1660050553",
        "amount_out": "1660050553",
        "ton_in": 1000000000,
        "ton_out": 2000000000,
        "user_wallet": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "router": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "jetton_master_in": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        },
        "jetton_master_out": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "SmartContractExec": {
        "executor": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "contract": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "ton_attached": 123456789,
        "operation": "NftTransfer or 0x35d95a12",
        "payload": "string",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "DomainRenew": {
        "domain": "vasya.ton",
        "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "renewer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "InscriptionTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "InscriptionMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "simple_preview": {
        "name": "Ton Transfer",
        "description": "Transferring 5 Ton",
        "action_image": "string",
        "value": "5 Ton",
        "value_image": "string",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          }
        ]
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false,
  "extra": 3
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/traces

Get traces for account

Parameters

account_idstringrequiredpath

account ID

limitinteger[1, 1000]100query

Response

200OK

account's traces

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/traces

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/traces'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/traces', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/traces')
data = response.json()

{
  "traces": [
    {
      "id": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "utime": 1645544908
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/subscriptions

Get all subscriptions by wallet address

Parameters

account_idstringrequiredpath

account ID

Response

200OK

account's subscriptions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/subscriptions

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/subscriptions'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/subscriptions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/subscriptions')
data = response.json()

{
  "subscriptions": [
    {
      "address": "0:dea8f638b789172ce36d10a20318125e52c649aa84893cd77858224fe2b9b0ee",
      "wallet_address": "0:567DE86AF2B6A557D7085807CF7C26338124987A5179344F0D0FA2657EB710F1",
      "beneficiary_address": "0:c704dadfabac88eab58e340de03080df81ff76636431f48624ad6e26fb2da0a4",
      "amount": 1000000000,
      "period": 2592000,
      "start_time": 1653996832,
      "timeout": 10800,
      "last_payment_time": 1653996834,
      "last_request_time": 0,
      "subscription_id": 217477,
      "failed_attempts": 0
    }
  ]
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/accounts/{account_id}/reindex

Update internal cache for a particular account

Parameters

account_idstringrequiredpath

account ID

Response

200OK

success

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/accounts/{account_id}/reindex

curl -X POST 'https://ton.nownodes.io/v2/accounts/{account_id}/reindex'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/reindex', {
  method: 'POST',
});

const data = await response.json();

import requests

response = requests.post('https://ton.nownodes.io/v2/accounts/{account_id}/reindex')
data = response.json()

default

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/search

Search by account domain name

Parameters

namestringrequiredquery

Response

200OK

found accounts

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/search

curl -X GET 'https://ton.nownodes.io/v2/accounts/search'

const response = await fetch('https://ton.nownodes.io/v2/accounts/search', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/search')
data = response.json()

{
  "addresses": [
    {
      "address": "0:010cеeac44fad23417a5c55e4071796868771082с9a61e8c195a8d57508b8471",
      "name": "blah_blah.ton",
      "preview": "https://cache.tonapi.io/images/media.jpg"
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/dns/expiring

Get expiring account .ton dns

Parameters

account_idstringrequiredpath

account ID

periodinteger[1, 3660]query

number of days before expiration

Response

200OK

account's expiring .ton dns

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/dns/expiring

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/dns/expiring'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/dns/expiring', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/dns/expiring')
data = response.json()

{
  "items": [
    {
      "expiring_at": "1678275313",
      "name": "blah_blah.ton",
      "dns_item": {
        "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "index": 58,
        "owner": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "collection": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "name": "TON Diamonds",
          "description": "Best collection in TON network"
        },
        "verified": true,
        "metadata": {},
        "sale": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "market": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "price": {
            "value": 123000000000,
            "token_name": "TON"
          }
        },
        "previews": [
          {
            "resolution": "100x100",
            "url": "https://site.com/pic1.jpg"
          }
        ],
        "dns": "crypto.ton",
        "approved_by": [
          "getgems"
        ]
      }
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/publickey

Get public key by account id

Parameters

account_idstringrequiredpath

account ID

Response

200OK

account's public key

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/publickey

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/publickey'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/publickey', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/publickey')
data = response.json()

{
  "public_key": "NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3..."
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/accounts/{account_id}/diff

Get account's balance change

Parameters

account_idstringrequiredpath

account ID

start_dateinteger<int64>requiredquery

end_dateinteger<int64>requiredquery

Response

200OK

account's balance change

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/accounts/{account_id}/diff

curl -X GET 'https://ton.nownodes.io/v2/accounts/{account_id}/diff'

const response = await fetch('https://ton.nownodes.io/v2/accounts/{account_id}/diff', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/accounts/{account_id}/diff')
data = response.json()

{
  "balance_change": 1000000000
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/dns/{domain_name}

Get full information about domain name

Parameters

domain_namestringrequiredpath

domain name with .ton or .t.me

Response

200OK

domain info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/dns/{domain_name}

curl -X GET 'https://ton.nownodes.io/v2/dns/{domain_name}'

const response = await fetch('https://ton.nownodes.io/v2/dns/{domain_name}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/dns/{domain_name}')
data = response.json()

{
  "name": "string",
  "expiring_at": 0,
  "item": {
    "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
    "index": 58,
    "owner": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "collection": {
      "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
      "name": "TON Diamonds",
      "description": "Best collection in TON network"
    },
    "verified": true,
    "metadata": {},
    "sale": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "market": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "price": {
        "value": 123000000000,
        "token_name": "TON"
      }
    },
    "previews": [
      {
        "resolution": "100x100",
        "url": "https://site.com/pic1.jpg"
      }
    ],
    "dns": "crypto.ton",
    "approved_by": [
      "getgems"
    ]
  }
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/dns/{domain_name}/resolve

DNS resolve for domain name

Parameters

domain_namestringrequiredpath

domain name with .ton or .t.me

Response

200OK

dns record

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/dns/{domain_name}/resolve

curl -X GET 'https://ton.nownodes.io/v2/dns/{domain_name}/resolve'

const response = await fetch('https://ton.nownodes.io/v2/dns/{domain_name}/resolve', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/dns/{domain_name}/resolve')
data = response.json()

{
  "wallet": {
    "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
    "account": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "is_wallet": true,
    "has_method_pubkey": true,
    "has_method_seqno": true,
    "names": [
      "name"
    ]
  },
  "next_resolver": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
  "sites": [
    "http://12234.ton"
  ],
  "storage": "da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/dns/{domain_name}/bids

Get domain bids

Parameters

domain_namestringrequiredpath

domain name with .ton or .t.me

Response

200OK

domain bids

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/dns/{domain_name}/bids

curl -X GET 'https://ton.nownodes.io/v2/dns/{domain_name}/bids'

const response = await fetch('https://ton.nownodes.io/v2/dns/{domain_name}/bids', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/dns/{domain_name}/bids')
data = response.json()

{
  "data": [
    {
      "success": true,
      "value": 1660050553,
      "txTime": 1660050553,
      "txHash": "55e8809519cd3c49098c9ee45afdafcea7a894a74d0f628d94a115a50e045122",
      "bidder": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      }
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/dns/auctions

Get all auctions

Parameters

tldstringquery

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

Response

200OK

auctions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/dns/auctions

curl -X GET 'https://ton.nownodes.io/v2/dns/auctions'

const response = await fetch('https://ton.nownodes.io/v2/dns/auctions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/dns/auctions')
data = response.json()

{
  "data": [
    {
      "domain": "wallet.ton",
      "owner": "owner",
      "price": 1660050553,
      "bids": 1660050553,
      "date": 1660050553
    }
  ],
  "total": 1660050553
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/nfts/collections

Get NFT collections

Parameters

limitinteger<int32>[1, 1000]100query

offsetinteger<int32>>= 00query

Response

200OK

nft collections

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/nfts/collections

curl -X GET 'https://ton.nownodes.io/v2/nfts/collections'

const response = await fetch('https://ton.nownodes.io/v2/nfts/collections', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/nfts/collections')
data = response.json()

{
  "nft_collections": [
    {
      "address": "0:FD595F36B4C1535BEC8461490D38EBB9AE3C38DD6ACE17CA63ABE2C6608BE159",
      "next_item_index": 1,
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "raw_collection_content": "697066733a2f2f516d596e437861746f5178433571584b79773971656768415853626f3544644e6a32387631487669437a47355359",
      "metadata": {},
      "previews": [
        {
          "resolution": "100x100",
          "url": "https://site.com/pic1.jpg"
        }
      ],
      "approved_by": [
        "getgems"
      ]
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/nfts/collections/{account_id}

Get NFT collection by collection address

Parameters

account_idstringrequiredpath

account ID

Response

200OK

nft collection

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/nfts/collections/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/nfts/collections/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/nfts/collections/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/nfts/collections/{account_id}')
data = response.json()

{
  "address": "0:FD595F36B4C1535BEC8461490D38EBB9AE3C38DD6ACE17CA63ABE2C6608BE159",
  "next_item_index": 1,
  "owner": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "raw_collection_content": "697066733a2f2f516d596e437861746f5178433571584b79773971656768415853626f3544644e6a32387631487669437a47355359",
  "metadata": {},
  "previews": [
    {
      "resolution": "100x100",
      "url": "https://site.com/pic1.jpg"
    }
  ],
  "approved_by": [
    "getgems"
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/nfts/collections/{account_id}/items

Get NFT items from collection by collection address

Parameters

account_idstringrequiredpath

account ID

limitinteger[1, 1000]1000query

offsetinteger>= 00query

Response

200OK

nft items

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/nfts/collections/{account_id}/items

curl -X GET 'https://ton.nownodes.io/v2/nfts/collections/{account_id}/items'

const response = await fetch('https://ton.nownodes.io/v2/nfts/collections/{account_id}/items', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/nfts/collections/{account_id}/items')
data = response.json()

{
  "nft_items": [
    {
      "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
      "index": 58,
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "collection": {
        "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "name": "TON Diamonds",
        "description": "Best collection in TON network"
      },
      "verified": true,
      "metadata": {},
      "sale": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "market": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "owner": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "price": {
          "value": 123000000000,
          "token_name": "TON"
        }
      },
      "previews": [
        {
          "resolution": "100x100",
          "url": "https://site.com/pic1.jpg"
        }
      ],
      "dns": "crypto.ton",
      "approved_by": [
        "getgems"
      ]
    }
  ]
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/nfts/_bulk

Get NFT items by their addresses

Body

application/json

a list of account ids

account_idsArray<string>required

Response

200OK

nft items

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/nfts/_bulk

curl -X POST 'https://ton.nownodes.io/v2/nfts/_bulk' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_ids": [
      "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
    ]
  }'

const response = await fetch('https://ton.nownodes.io/v2/nfts/_bulk', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_ids": [
        "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "account_ids": [
    "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
  ]
}

response = requests.post('https://ton.nownodes.io/v2/nfts/_bulk', json=payload)
data = response.json()

Request Body

{
  "account_ids": [
    "0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"
  ]
}

{
  "nft_items": [
    {
      "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
      "index": 58,
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "collection": {
        "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "name": "TON Diamonds",
        "description": "Best collection in TON network"
      },
      "verified": true,
      "metadata": {},
      "sale": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "market": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "owner": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "price": {
          "value": 123000000000,
          "token_name": "TON"
        }
      },
      "previews": [
        {
          "resolution": "100x100",
          "url": "https://site.com/pic1.jpg"
        }
      ],
      "dns": "crypto.ton",
      "approved_by": [
        "getgems"
      ]
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/nfts/{account_id}

Get NFT item by its address

Parameters

account_idstringrequiredpath

account ID

Response

200OK

nft item

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/nfts/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/nfts/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/nfts/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/nfts/{account_id}')
data = response.json()

{
  "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
  "index": 58,
  "owner": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "collection": {
    "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
    "name": "TON Diamonds",
    "description": "Best collection in TON network"
  },
  "verified": true,
  "metadata": {},
  "sale": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "market": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "owner": {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "is_wallet": true
    },
    "price": {
      "value": 123000000000,
      "token_name": "TON"
    }
  },
  "previews": [
    {
      "resolution": "100x100",
      "url": "https://site.com/pic1.jpg"
    }
  ],
  "dns": "crypto.ton",
  "approved_by": [
    "getgems"
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/nfts/{account_id}/history

Get the transfer nfts history for account

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 1000]requiredquery

start_dateinteger<int64>query

end_dateinteger<int64>query

Response

200OK

nft history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/nfts/{account_id}/history

curl -X GET 'https://ton.nownodes.io/v2/nfts/{account_id}/history'

const response = await fetch('https://ton.nownodes.io/v2/nfts/{account_id}/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/nfts/{account_id}/history')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/traces/{trace_id}

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

Parameters

trace_idstringrequiredpath

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

Response

200OK

trace

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/traces/{trace_id}

curl -X GET 'https://ton.nownodes.io/v2/traces/{trace_id}'

const response = await fetch('https://ton.nownodes.io/v2/traces/{trace_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/traces/{trace_id}')
data = response.json()

default

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/events/{event_id}

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.

Parameters

event_idstringrequiredpath

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

Accept-Languagestringenheader

Response

200OK

event

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/events/{event_id}

curl -X GET 'https://ton.nownodes.io/v2/events/{event_id}'

const response = await fetch('https://ton.nownodes.io/v2/events/{event_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/events/{event_id}')
data = response.json()

{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "timestamp": 1234567890,
  "actions": [
    {
      "type": "TonTransfer",
      "status": "ok",
      "TonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 123456789,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "ContractDeploy": {
        "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "interfaces": [
          "nft_item",
          "nft_royalty"
        ]
      },
      "JettonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        },
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonBurn": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "NftItemTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "nft": "",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "payload": "0234de3e21d21b3ee21f3",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "Subscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 1000000000,
        "initial": false
      },
      "UnSubscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "AuctionBid": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "bidder": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "auction": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "NftPurchase": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "seller": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "buyer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "DepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStakeRequest": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "ElectionsDepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "ElectionsRecoverStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "JettonSwap": {
        "dex": "stonfi",
        "amount_in": "1660050553",
        "amount_out": "1660050553",
        "ton_in": 1000000000,
        "ton_out": 2000000000,
        "user_wallet": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "router": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "jetton_master_in": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        },
        "jetton_master_out": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "SmartContractExec": {
        "executor": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "contract": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "ton_attached": 123456789,
        "operation": "NftTransfer or 0x35d95a12",
        "payload": "string",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "DomainRenew": {
        "domain": "vasya.ton",
        "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "renewer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "InscriptionTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "InscriptionMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "simple_preview": {
        "name": "Ton Transfer",
        "description": "Transferring 5 Ton",
        "action_image": "string",
        "value": "5 Ton",
        "value_image": "string",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          }
        ]
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "value_flow": [
    {
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "ton": 80,
      "fees": 10,
      "jettons": [
        {
          "account": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "jetton": {
            "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
            "name": "Wrapped TON",
            "symbol": "WTON",
            "decimals": 9,
            "image": "https://cache.tonapi.io/images/jetton.jpg",
            "verification": "whitelist"
          },
          "quantity": 10
        }
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions

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

Parameters

account_idstringrequiredpath

account ID

limitinteger[1, 1000]1000query

offsetinteger>= 00query

Response

200OK

account inscriptions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/experimental/accounts/{account_id}/inscriptions

curl -X GET 'https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions'

const response = await fetch('https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions')
data = response.json()

{
  "inscriptions": [
    {
      "type": "ton20",
      "ticker": "nano",
      "balance": "1000000000",
      "decimals": 9
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/history

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

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 1000]100query

Response

200OK

account inscriptions history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/experimental/accounts/{account_id}/inscriptions/history

curl -X GET 'https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/history'

const response = await fetch('https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/history')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/{ticker}/history

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

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

tickerstringrequiredpath

before_ltinteger<int64>query

omit this parameter to get last events

limitinteger[1, 1000]100query

Response

200OK

account inscriptions history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/experimental/accounts/{account_id}/inscriptions/{ticker}/history

curl -X GET 'https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/{ticker}/history'

const response = await fetch('https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/{ticker}/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/experimental/accounts/{account_id}/inscriptions/{ticker}/history')
data = response.json()

{
  "events": [
    {
      "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "timestamp": 1234567890,
      "actions": [
        {
          "type": "TonTransfer",
          "status": "ok",
          "TonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 123456789,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "ContractDeploy": {
            "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "interfaces": [
              "nft_item",
              "nft_royalty"
            ]
          },
          "JettonTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            },
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonBurn": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "JettonMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "amount": 1000000000,
            "jetton": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "NftItemTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "nft": "",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "encrypted_comment": {
              "encryption_type": "simple",
              "cipher_text": "A6A0BD6608672B...CE3AF8DB"
            },
            "payload": "0234de3e21d21b3ee21f3",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "Subscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": 1000000000,
            "initial": false
          },
          "UnSubscribe": {
            "subscriber": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "beneficiary": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "AuctionBid": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "bidder": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "auction": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "NftPurchase": {
            "auction_type": "DNS.ton",
            "amount": {
              "value": 123000000000,
              "token_name": "TON"
            },
            "nft": {
              "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
              "index": 58,
              "owner": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              },
              "collection": {
                "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
                "name": "TON Diamonds",
                "description": "Best collection in TON network"
              },
              "verified": true,
              "metadata": {},
              "sale": {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "market": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "owner": {
                  "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                  "name": "Ton foundation",
                  "is_scam": true,
                  "icon": "https://ton.org/logo.png",
                  "is_wallet": true
                },
                "price": {
                  "value": 123000000000,
                  "token_name": "TON"
                }
              },
              "previews": [
                {
                  "resolution": "100x100",
                  "url": "https://site.com/pic1.jpg"
                }
              ],
              "dns": "crypto.ton",
              "approved_by": [
                "getgems"
              ]
            },
            "seller": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "buyer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "DepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "WithdrawStakeRequest": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "pool": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "implementation": "whales"
          },
          "ElectionsDepositStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "ElectionsRecoverStake": {
            "amount": 1660050553,
            "staker": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "JettonSwap": {
            "dex": "stonfi",
            "amount_in": "1660050553",
            "amount_out": "1660050553",
            "ton_in": 1000000000,
            "ton_out": 2000000000,
            "user_wallet": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "router": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "jetton_master_in": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            },
            "jetton_master_out": {
              "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
              "name": "Wrapped TON",
              "symbol": "WTON",
              "decimals": 9,
              "image": "https://cache.tonapi.io/images/jetton.jpg",
              "verification": "whitelist"
            }
          },
          "SmartContractExec": {
            "executor": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "contract": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "ton_attached": 123456789,
            "operation": "NftTransfer or 0x35d95a12",
            "payload": "string",
            "refund": {
              "type": "DNS.ton",
              "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
            }
          },
          "DomainRenew": {
            "domain": "vasya.ton",
            "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
            "renewer": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            }
          },
          "InscriptionTransfer": {
            "sender": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "comment": "Hi! This is your salary. \nFrom accounting with love.",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "InscriptionMint": {
            "recipient": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "amount": "123456789",
            "type": "ton20",
            "ticker": "nano",
            "decimals": 9
          },
          "simple_preview": {
            "name": "Ton Transfer",
            "description": "Transferring 5 Ton",
            "action_image": "string",
            "value": "5 Ton",
            "value_image": "string",
            "accounts": [
              {
                "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
                "name": "Ton foundation",
                "is_scam": true,
                "icon": "https://ton.org/logo.png",
                "is_wallet": true
              }
            ]
          },
          "base_transactions": [
            "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
          ]
        }
      ],
      "is_scam": false,
      "lt": 25713146000001,
      "in_progress": false,
      "extra": 3
    }
  ],
  "next_from": 25713146000001
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/experimental/inscriptions/op-template

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

Parameters

typestrington20gram20requiredquery

destinationstringquery

commentstringquery

operationstringtransferrequiredquery

amountstringrequiredquery

tickerstringrequiredquery

whostringrequiredquery

Response

200OK

inscription op template

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/experimental/inscriptions/op-template

curl -X GET 'https://ton.nownodes.io/v2/experimental/inscriptions/op-template'

const response = await fetch('https://ton.nownodes.io/v2/experimental/inscriptions/op-template', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/experimental/inscriptions/op-template')
data = response.json()

{
  "comment": "comment",
  "destination": "0:0000000000000"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/jettons

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

Parameters

limitinteger<int32>[1, 1000]100query

offsetinteger<int32>>= 00query

Response

200OK

a list of jettons

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/jettons

curl -X GET 'https://ton.nownodes.io/v2/jettons'

const response = await fetch('https://ton.nownodes.io/v2/jettons', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/jettons')
data = response.json()

{
  "jettons": [
    {
      "mintable": true,
      "total_supply": 311500000000000,
      "admin": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "metadata": {
        "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
        "name": "Wrapped TON",
        "symbol": "WTON",
        "decimals": "9",
        "image": "https://cache.tonapi.io/images/jetton.jpg",
        "description": "Wrapped Toncoin",
        "social": [
          [
            "https://t.me/durov_coin",
            "https://twitter.com/durov_coin"
          ]
        ],
        "websites": [
          [
            "https://durov.coin",
            "ton://durov-coin.ton"
          ]
        ],
        "catalogs": [
          [
            "https://coinmarketcap.com/currencies/drv/",
            "https://www.coingecko.com/en/coins/durov"
          ]
        ]
      },
      "verification": "whitelist",
      "holders_count": 2000
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/jettons/{account_id}

Get jetton metadata by jetton master address

Parameters

account_idstringrequiredpath

account ID

Response

200OK

jetton info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/jettons/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/jettons/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/jettons/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/jettons/{account_id}')
data = response.json()

{
  "mintable": true,
  "total_supply": 311500000000000,
  "admin": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "name": "Ton foundation",
    "is_scam": true,
    "icon": "https://ton.org/logo.png",
    "is_wallet": true
  },
  "metadata": {
    "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
    "name": "Wrapped TON",
    "symbol": "WTON",
    "decimals": "9",
    "image": "https://cache.tonapi.io/images/jetton.jpg",
    "description": "Wrapped Toncoin",
    "social": [
      [
        "https://t.me/durov_coin",
        "https://twitter.com/durov_coin"
      ]
    ],
    "websites": [
      [
        "https://durov.coin",
        "ton://durov-coin.ton"
      ]
    ],
    "catalogs": [
      [
        "https://coinmarketcap.com/currencies/drv/",
        "https://www.coingecko.com/en/coins/durov"
      ]
    ]
  },
  "verification": "whitelist",
  "holders_count": 2000
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/jettons/{account_id}/holders

Get jetton's holders

Parameters

account_idstringrequiredpath

account ID

limitinteger[1, 1000]1000query

offsetinteger>= 00query

Response

200OK

jetton's holders

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/jettons/{account_id}/holders

curl -X GET 'https://ton.nownodes.io/v2/jettons/{account_id}/holders'

const response = await fetch('https://ton.nownodes.io/v2/jettons/{account_id}/holders', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/jettons/{account_id}/holders')
data = response.json()

{
  "addresses": [
    {
      "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "balance": 1000000000
    }
  ],
  "total": 2000
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/events/{event_id}/jettons

Get only jetton transfers in the event

Parameters

event_idstringrequiredpath

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

Accept-Languagestringenheader

Response

200OK

events

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/events/{event_id}/jettons

curl -X GET 'https://ton.nownodes.io/v2/events/{event_id}/jettons'

const response = await fetch('https://ton.nownodes.io/v2/events/{event_id}/jettons', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/events/{event_id}/jettons')
data = response.json()

{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "timestamp": 1234567890,
  "actions": [
    {
      "type": "TonTransfer",
      "status": "ok",
      "TonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 123456789,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "ContractDeploy": {
        "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "interfaces": [
          "nft_item",
          "nft_royalty"
        ]
      },
      "JettonTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        },
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonBurn": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "senders_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "JettonMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipients_wallet": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "amount": 1000000000,
        "jetton": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "NftItemTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "nft": "",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "encrypted_comment": {
          "encryption_type": "simple",
          "cipher_text": "A6A0BD6608672B...CE3AF8DB"
        },
        "payload": "0234de3e21d21b3ee21f3",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "Subscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": 1000000000,
        "initial": false
      },
      "UnSubscribe": {
        "subscriber": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "subscription": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "beneficiary": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "AuctionBid": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "bidder": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "auction": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "NftPurchase": {
        "auction_type": "DNS.ton",
        "amount": {
          "value": 123000000000,
          "token_name": "TON"
        },
        "nft": {
          "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
          "index": 58,
          "owner": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "collection": {
            "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
            "name": "TON Diamonds",
            "description": "Best collection in TON network"
          },
          "verified": true,
          "metadata": {},
          "sale": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "market": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "owner": {
              "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
              "name": "Ton foundation",
              "is_scam": true,
              "icon": "https://ton.org/logo.png",
              "is_wallet": true
            },
            "price": {
              "value": 123000000000,
              "token_name": "TON"
            }
          },
          "previews": [
            {
              "resolution": "100x100",
              "url": "https://site.com/pic1.jpg"
            }
          ],
          "dns": "crypto.ton",
          "approved_by": [
            "getgems"
          ]
        },
        "seller": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "buyer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "DepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "WithdrawStakeRequest": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "pool": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "implementation": "whales"
      },
      "ElectionsDepositStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "ElectionsRecoverStake": {
        "amount": 1660050553,
        "staker": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "JettonSwap": {
        "dex": "stonfi",
        "amount_in": "1660050553",
        "amount_out": "1660050553",
        "ton_in": 1000000000,
        "ton_out": 2000000000,
        "user_wallet": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "router": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "jetton_master_in": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        },
        "jetton_master_out": {
          "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
          "name": "Wrapped TON",
          "symbol": "WTON",
          "decimals": 9,
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "verification": "whitelist"
        }
      },
      "SmartContractExec": {
        "executor": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "contract": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "ton_attached": 123456789,
        "operation": "NftTransfer or 0x35d95a12",
        "payload": "string",
        "refund": {
          "type": "DNS.ton",
          "origin": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf"
        }
      },
      "DomainRenew": {
        "domain": "vasya.ton",
        "contract_address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
        "renewer": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        }
      },
      "InscriptionTransfer": {
        "sender": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "comment": "Hi! This is your salary. \nFrom accounting with love.",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "InscriptionMint": {
        "recipient": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "name": "Ton foundation",
          "is_scam": true,
          "icon": "https://ton.org/logo.png",
          "is_wallet": true
        },
        "amount": "123456789",
        "type": "ton20",
        "ticker": "nano",
        "decimals": 9
      },
      "simple_preview": {
        "name": "Ton Transfer",
        "description": "Transferring 5 Ton",
        "action_image": "string",
        "value": "5 Ton",
        "value_image": "string",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          }
        ]
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "value_flow": [
    {
      "account": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "name": "Ton foundation",
        "is_scam": true,
        "icon": "https://ton.org/logo.png",
        "is_wallet": true
      },
      "ton": 80,
      "fees": 10,
      "jettons": [
        {
          "account": {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "name": "Ton foundation",
            "is_scam": true,
            "icon": "https://ton.org/logo.png",
            "is_wallet": true
          },
          "jetton": {
            "address": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0",
            "name": "Wrapped TON",
            "symbol": "WTON",
            "decimals": 9,
            "image": "https://cache.tonapi.io/images/jetton.jpg",
            "verification": "whitelist"
          },
          "quantity": 10
        }
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/staking/nominator/{account_id}/pools

All pools where account participates

Parameters

account_idstringrequiredpath

account ID

Response

200OK

account's pools

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/staking/nominator/{account_id}/pools

curl -X GET 'https://ton.nownodes.io/v2/staking/nominator/{account_id}/pools'

const response = await fetch('https://ton.nownodes.io/v2/staking/nominator/{account_id}/pools', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/staking/nominator/{account_id}/pools')
data = response.json()

{
  "pools": [
    {
      "pool": "EQBI-wGVp_x0VFEjd7m9cEUD3tJ_bnxMSp0Tb9qz757ATEAM",
      "amount": 10050000000000,
      "pending_deposit": 500000000000,
      "pending_withdraw": 500000000000,
      "ready_withdraw": 500000000000
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/staking/pool/{account_id}

Stacking pool info

Parameters

account_idstringrequiredpath

account ID

Accept-Languagestringenheader

Response

200OK

stacking pool info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/staking/pool/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/staking/pool/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/staking/pool/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/staking/pool/{account_id}')
data = response.json()

{
  "implementation": {
    "name": "TON Whales",
    "description": "Oldest pool with minimal staking amount 50 TON",
    "url": "https://tonvalidators.org/",
    "socials": [
      "https://t.me/tonwhales"
    ]
  },
  "pool": {
    "address": "0:48fb0195a7fc7454512377b9bd704503ded27f6e7c4c4a9d136fdab3ef9ec04c",
    "name": "Tonkeeper pool",
    "total_amount": 0,
    "implementation": "whales",
    "apy": 5.31,
    "min_stake": 5000000000,
    "cycle_start": 1678223064,
    "cycle_end": 1678223064,
    "verified": true,
    "current_nominators": 10,
    "max_nominators": 100,
    "liquid_jetton_master": "0:4a91d32d0289bda9813ae00ff7640e6c38fdce76e4583dd6afc463b70c7d767c",
    "nominators_stake": 5000000000,
    "validator_stake": 5000000000,
    "cycle_length": 0
  }
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/staking/pool/{account_id}/history

Pool history

Parameters

account_idstringrequiredpath

account ID

Response

200OK

pool history

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/staking/pool/{account_id}/history

curl -X GET 'https://ton.nownodes.io/v2/staking/pool/{account_id}/history'

const response = await fetch('https://ton.nownodes.io/v2/staking/pool/{account_id}/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/staking/pool/{account_id}/history')
data = response.json()

{
  "apy": [
    {
      "apy": 0,
      "time": 0
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/staking/pools

All pools available in network

Parameters

available_forstringquery

account ID

include_unverifiedbooleanquery

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

Accept-Languagestringenheader

Response

200OK

a list of pools

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/staking/pools

curl -X GET 'https://ton.nownodes.io/v2/staking/pools'

const response = await fetch('https://ton.nownodes.io/v2/staking/pools', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/staking/pools')
data = response.json()

{
  "pools": [
    {
      "address": "0:48fb0195a7fc7454512377b9bd704503ded27f6e7c4c4a9d136fdab3ef9ec04c",
      "name": "Tonkeeper pool",
      "total_amount": 0,
      "implementation": "whales",
      "apy": 5.31,
      "min_stake": 5000000000,
      "cycle_start": 1678223064,
      "cycle_end": 1678223064,
      "verified": true,
      "current_nominators": 10,
      "max_nominators": 100,
      "liquid_jetton_master": "0:4a91d32d0289bda9813ae00ff7640e6c38fdce76e4583dd6afc463b70c7d767c",
      "nominators_stake": 5000000000,
      "validator_stake": 5000000000,
      "cycle_length": 0
    }
  ],
  "implementations": {}
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/storage/providers

Get TON storage providers deployed to the blockchain.

Response

200OK

a list of storage providers

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/storage/providers

curl -X GET 'https://ton.nownodes.io/v2/storage/providers'

const response = await fetch('https://ton.nownodes.io/v2/storage/providers', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/storage/providers')
data = response.json()

{
  "providers": [
    {
      "address": "0:FD595F36B4C1535BEC8461490D38EBB9AE3C38DD6ACE17CA63ABE2C6608BE159",
      "accept_new_contracts": true,
      "rate_per_mb_day": 50000000,
      "max_span": 604800,
      "minimal_file_size": 64,
      "maximal_file_size": 10485760
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/rates

Get the token price to the currency

Parameters

tokensArray<string>requiredquery

accept ton and jetton master addresses, separated by commas

currenciesArray<string>requiredquery

accept ton and all possible fiat currencies, separated by commas

Response

200OK

tokens rates

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/rates

curl -X GET 'https://ton.nownodes.io/v2/rates'

const response = await fetch('https://ton.nownodes.io/v2/rates', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/rates')
data = response.json()

{
  "rates": {}
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/rates/chart

Get chart by token

Parameters

tokenstringrequiredquery

accept jetton master address

currencystringquery

start_dateinteger<int64>query

end_dateinteger<int64>query

points_countinteger<int>[0, 200]200query

Response

200OK

token chart

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/rates/chart

curl -X GET 'https://ton.nownodes.io/v2/rates/chart'

const response = await fetch('https://ton.nownodes.io/v2/rates/chart', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/rates/chart')
data = response.json()

{
  "points": {}
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/rates/markets

Get the TON price from markets

Response

200OK

markets rates

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/rates/markets

curl -X GET 'https://ton.nownodes.io/v2/rates/markets'

const response = await fetch('https://ton.nownodes.io/v2/rates/markets', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/rates/markets')
data = response.json()

{
  "markets": [
    {
      "market": "OKX",
      "usd_price": 5.2,
      "last_date_update": 1668436763
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/tonconnect/payload

Get a payload for further token receipt

Response

200OK

payload

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/tonconnect/payload

curl -X GET 'https://ton.nownodes.io/v2/tonconnect/payload'

const response = await fetch('https://ton.nownodes.io/v2/tonconnect/payload', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/tonconnect/payload')
data = response.json()

{
  "payload": "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa"
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/tonconnect/stateinit

Get account info by state init

Body

application/json

Data that is expected

state_initstringrequired

Response

200OK

account info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/tonconnect/stateinit

curl -X POST 'https://ton.nownodes.io/v2/tonconnect/stateinit' \
  -H 'Content-Type: application/json' \
  -d '{
    "state_init": "string"
  }'

const response = await fetch('https://ton.nownodes.io/v2/tonconnect/stateinit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "state_init": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "state_init": "string"
}

response = requests.post('https://ton.nownodes.io/v2/tonconnect/stateinit', json=payload)
data = response.json()

Request Body

{
  "state_init": "string"
}

{
  "public_key": "NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3...",
  "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/wallet/backup

Get backup info

Parameters

X-TonConnect-Authstringrequiredheader

Response

200OK

get wallet dump

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/wallet/backup

curl -X GET 'https://ton.nownodes.io/v2/wallet/backup'

const response = await fetch('https://ton.nownodes.io/v2/wallet/backup', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/wallet/backup')
data = response.json()

{
  "dump": "string"
}

{
  "error": "string"
}

PUT

https://ton.nownodes.io/v2/wallet/backup

Set backup info

Body

application/octet-stream

Information for saving backup

string<binary>

Parameters

X-TonConnect-Authstringrequiredheader

Response

200OK

success

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

PUT /v2/wallet/backup

curl -X PUT 'https://ton.nownodes.io/v2/wallet/backup' \
  -H 'Content-Type: application/octet-stream' \
  -d '"<binary>"'

const response = await fetch('https://ton.nownodes.io/v2/wallet/backup', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/octet-stream',
  },
  body: JSON.stringify("<binary>"),
});

const data = await response.json();

import requests

payload = "<binary>"

response = requests.put('https://ton.nownodes.io/v2/wallet/backup', json=payload)
data = response.json()

Request Body

"<binary>"

default

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/wallet/auth/proof

Account verification and token issuance

Body

application/json

Data that is expected from TON Connect

addressstringrequired

proofobjectrequired

Show child attributes

timestampinteger<int64>required

domainobjectrequired

Show child attributes

length_bytesinteger<int32>

valuestringrequired

signaturestringrequired

payloadstringrequired

state_initstring

Response

200OK

auth token

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/wallet/auth/proof

curl -X POST 'https://ton.nownodes.io/v2/wallet/auth/proof' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
    "proof": {
      "timestamp": "1678275313",
      "domain": {
        "length_bytes": 0,
        "value": "string"
      },
      "signature": "string",
      "payload": "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa",
      "state_init": "string"
    }
  }'

const response = await fetch('https://ton.nownodes.io/v2/wallet/auth/proof', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
      "proof": {
        "timestamp": "1678275313",
        "domain": {
          "length_bytes": 0,
          "value": "string"
        },
        "signature": "string",
        "payload": "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa",
        "state_init": "string"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
  "proof": {
    "timestamp": "1678275313",
    "domain": {
      "length_bytes": 0,
      "value": "string"
    },
    "signature": "string",
    "payload": "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa",
    "state_init": "string"
  }
}

response = requests.post('https://ton.nownodes.io/v2/wallet/auth/proof', json=payload)
data = response.json()

Request Body

{
  "address": "0:97146a46acc2654y27947f14c4a4b14273e954f78bc017790b41208b0043200b",
  "proof": {
    "timestamp": "1678275313",
    "domain": {
      "length_bytes": 0,
      "value": "string"
    },
    "signature": "string",
    "payload": "84jHVNLQmZsAAAAAZB0Zryi2wqVJI-KaKNXOvCijEi46YyYzkaSHyJrMPBMOkVZa",
    "state_init": "string"
  }
}

{
  "token": "NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2ODQ3..."
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/pubkeys/{public_key}/wallets

Get wallets by public key

Parameters

public_keystringrequiredpath

Response

200OK

a list of wallets

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/pubkeys/{public_key}/wallets

curl -X GET 'https://ton.nownodes.io/v2/pubkeys/{public_key}/wallets'

const response = await fetch('https://ton.nownodes.io/v2/pubkeys/{public_key}/wallets', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/pubkeys/{public_key}/wallets')
data = response.json()

{
  "accounts": [
    {
      "address": "0:da6b1b6663a0e4d18cc8574ccd9db5296e367dd9324706f3bbd9eb1cd2caf0bf",
      "balance": 123456789,
      "last_activity": 123456789,
      "status": "active",
      "interfaces": [
        "nft_sale"
      ],
      "name": "Ton foundation",
      "is_scam": true,
      "icon": "https://ton.org/logo.png",
      "memo_required": true,
      "get_methods": [
        "get_item_data"
      ],
      "is_suspended": true,
      "is_wallet": true
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/wallet/{account_id}/seqno

Get account seqno

Parameters

account_idstringrequiredpath

account ID

Response

200OK

account seqno

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/wallet/{account_id}/seqno

curl -X GET 'https://ton.nownodes.io/v2/wallet/{account_id}/seqno'

const response = await fetch('https://ton.nownodes.io/v2/wallet/{account_id}/seqno', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/wallet/{account_id}/seqno')
data = response.json()

{
  "seqno": 0
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_masterchain_info

Get raw masterchain info

Response

200OK

raw masterchain info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_masterchain_info

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_masterchain_info'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_masterchain_info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_masterchain_info')
data = response.json()

{
  "last": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "state_root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "init": {
    "workchain": 4294967295,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  }
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_masterchain_info_ext

Get raw masterchain info ext

Parameters

modeinteger<int32>requiredquery

mode

Response

200OK

raw masterchain info ext

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_masterchain_info_ext

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_masterchain_info_ext'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_masterchain_info_ext', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_masterchain_info_ext')
data = response.json()

{
  "mode": 0,
  "version": 257,
  "capabilities": 7,
  "last": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "last_utime": 1687938199,
  "now": 1687938204,
  "state_root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "init": {
    "workchain": 4294967295,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  }
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_time

Get raw time

Response

200OK

raw time

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_time

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_time'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_time', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_time')
data = response.json()

{
  "time": 1687146728
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_block/{block_id}

Get raw blockchain block

Parameters

block_idstringrequiredpath

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

Response

200OK

raw blockchain block

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_block/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_block/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_block/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_block/{block_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "data": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_state/{block_id}

Get raw blockchain block state

Parameters

block_idstringrequiredpath

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

Response

200OK

raw blockchain block state

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_state/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_state/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_state/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_state/{block_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB",
  "data": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_block_header/{block_id}

Get raw blockchain block header

Parameters

block_idstringrequiredpath

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

modeinteger<int32>requiredquery

mode

Response

200OK

raw blockchain block header

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_block_header/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_block_header/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_block_header/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_block_header/{block_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "mode": 0,
  "header_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

POST

https://ton.nownodes.io/v2/liteserver/send_message

Send raw message to blockchain

Body

application/json

Data that is expected

bodystringrequired

Response

200OK

code

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

POST /v2/liteserver/send_message

curl -X POST 'https://ton.nownodes.io/v2/liteserver/send_message' \
  -H 'Content-Type: application/json' \
  -d '{
    "body": "string"
  }'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/send_message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "body": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "body": "string"
}

response = requests.post('https://ton.nownodes.io/v2/liteserver/send_message', json=payload)
data = response.json()

Request Body

{
  "body": "string"
}

{
  "code": 200
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_account_state/{account_id}

Get raw account state

Parameters

account_idstringrequiredpath

account ID

target_blockstringquery

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

Response

200OK

raw account state

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_account_state/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_account_state/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_account_state/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_account_state/{account_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "shardblk": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "shard_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "state": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_shard_info/{block_id}

Get raw shard info

Parameters

block_idstringrequiredpath

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

workchaininteger<int32>requiredquery

workchain

shardinteger<int64>requiredquery

shard

exactbooleanrequiredquery

exact

Response

200OK

raw shard info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_shard_info/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_shard_info/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_shard_info/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_shard_info/{block_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "shardblk": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "shard_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "shard_descr": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_all_shards_info/{block_id}

Get all raw shards info

Parameters

block_idstringrequiredpath

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

Response

200OK

all raw shards info

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_all_shards_info/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_all_shards_info/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_all_shards_info/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_all_shards_info/{block_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "data": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_transactions/{account_id}

Get raw transactions

Parameters

account_idstringrequiredpath

account ID

countinteger<int32>requiredquery

count

ltinteger<int64>requiredquery

hashstringrequiredquery

hash

Response

200OK

raw transactions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_transactions/{account_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_transactions/{account_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_transactions/{account_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_transactions/{account_id}')
data = response.json()

{
  "ids": [
    {
      "workchain": 4294967295,
      "shard": 800000000000000,
      "seqno": 30699640,
      "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
      "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
    }
  ],
  "transactions": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/list_block_transactions/{block_id}

Get raw list block transactions

Parameters

block_idstringrequiredpath

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

modeinteger<int32>requiredquery

mode

countinteger<int32>requiredquery

count

account_idstringquery

account ID

ltinteger<int64>query

Response

200OK

a list of raw block transactions

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/list_block_transactions/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/list_block_transactions/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/list_block_transactions/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/list_block_transactions/{block_id}')
data = response.json()

{
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "req_count": 100,
  "incomplete": true,
  "ids": [
    {
      "mode": 0,
      "account": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
      "lt": 0,
      "hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
    }
  ],
  "proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_block_proof

Get raw block proof

Parameters

known_blockstringrequiredquery

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

target_blockstringquery

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

modeinteger<int32>requiredquery

mode

Response

200OK

raw block proof

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_block_proof

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_block_proof'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_block_proof', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_block_proof')
data = response.json()

{
  "complete": true,
  "from": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "to": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "steps": [
    {
      "lite_server_block_link_back": {
        "to_key_block": false,
        "from": {
          "workchain": 4294967295,
          "shard": 800000000000000,
          "seqno": 30699640,
          "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
          "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
        },
        "to": {
          "workchain": 4294967295,
          "shard": 800000000000000,
          "seqno": 30699640,
          "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
          "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
        },
        "dest_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
        "proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
        "state_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
      },
      "lite_server_block_link_forward": {
        "to_key_block": false,
        "from": {
          "workchain": 4294967295,
          "shard": 800000000000000,
          "seqno": 30699640,
          "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
          "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
        },
        "to": {
          "workchain": 4294967295,
          "shard": 800000000000000,
          "seqno": 30699640,
          "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
          "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
        },
        "dest_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
        "config_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
        "signatures": {
          "validator_set_hash": 0,
          "catchain_seqno": 0,
          "signatures": [
            {
              "node_id_short": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
              "signature": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
            }
          ]
        }
      }
    }
  ]
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_config_all/{block_id}

Get raw config

Parameters

block_idstringrequiredpath

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

modeinteger<int32>requiredquery

mode

Response

200OK

raw config

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_config_all/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_config_all/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_config_all/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_config_all/{block_id}')
data = response.json()

{
  "mode": 0,
  "id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "state_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
  "config_proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
}

{
  "error": "string"
}

GET

https://ton.nownodes.io/v2/liteserver/get_shard_block_proof/{block_id}

Get raw shard block proof

Parameters

block_idstringrequiredpath

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

Response

200OK

raw shard block proof

default

Some error during request processing

Authorization

api-keyAuthapiKey in header

GET /v2/liteserver/get_shard_block_proof/{block_id}

curl -X GET 'https://ton.nownodes.io/v2/liteserver/get_shard_block_proof/{block_id}'

const response = await fetch('https://ton.nownodes.io/v2/liteserver/get_shard_block_proof/{block_id}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/v2/liteserver/get_shard_block_proof/{block_id}')
data = response.json()

{
  "masterchain_id": {
    "workchain": 4294967295,
    "shard": 800000000000000,
    "seqno": 30699640,
    "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
    "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
  },
  "links": [
    {
      "id": {
        "workchain": 4294967295,
        "shard": 800000000000000,
        "seqno": 30699640,
        "root_hash": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85",
        "file_hash": "A6A0BD6608672B11B79538A50B2204E748305C12AA0DED9C16CF0006CE3AF8DB"
      },
      "proof": "131D0C65055F04E9C19D687B51BC70F952FD9CA6F02C2801D3B89964A779DF85"
    }
  ]
}

{
  "error": "string"
}

TON Index (mainnet)

API V3 Reference (Index)

Get Masterchain Info

GET

https://ton.nownodes.io/masterchainInfo

Get up-to-date masterchain state.

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Masterchain Info

curl -X GET 'https://ton.nownodes.io/masterchainInfo'

const response = await fetch('https://ton.nownodes.io/masterchainInfo', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/masterchainInfo')
data = response.json()

200

{
  "last": {
    "workchain": 0,
    "shard": "string",
    "seqno": 0,
    "root_hash": "string",
    "file_hash": "string",
    "global_id": 0,
    "version": 0,
    "after_merge": true,
    "before_split": true,
    "after_split": true,
    "want_merge": true,
    "want_split": true,
    "key_block": true,
    "vert_seqno_incr": true,
    "flags": 0,
    "gen_utime": "string",
    "start_lt": "string",
    "end_lt": "string",
    "validator_list_hash_short": 0,
    "gen_catchain_seqno": 0,
    "min_ref_mc_seqno": 0,
    "prev_key_block_seqno": 0,
    "vert_seqno": 0,
    "master_ref_seqno": 0,
    "rand_seed": "string",
    "created_by": "string",
    "tx_count": 0,
    "masterchain_block_ref": {
      "workchain": 0,
      "shard": "string",
      "seqno": 0
    },
    "prev_blocks": [
      {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      }
    ]
  },
  "first": {
    "workchain": 0,
    "shard": "string",
    "seqno": 0,
    "root_hash": "string",
    "file_hash": "string",
    "global_id": 0,
    "version": 0,
    "after_merge": true,
    "before_split": true,
    "after_split": true,
    "want_merge": true,
    "want_split": true,
    "key_block": true,
    "vert_seqno_incr": true,
    "flags": 0,
    "gen_utime": "string",
    "start_lt": "string",
    "end_lt": "string",
    "validator_list_hash_short": 0,
    "gen_catchain_seqno": 0,
    "min_ref_mc_seqno": 0,
    "prev_key_block_seqno": 0,
    "vert_seqno": 0,
    "master_ref_seqno": 0,
    "rand_seed": "string",
    "created_by": "string",
    "tx_count": 0,
    "masterchain_block_ref": {
      "workchain": 0,
      "shard": "string",
      "seqno": 0
    },
    "prev_blocks": [
      {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      }
    ]
  }
}

Get Blocks

GET

https://ton.nownodes.io/blocks

Returns blocks by specified filters.

Parameters

workchainintegerquery

Block workchain.

shardstringquery

Block shard id. Must be sent with workchain. Example: 8000000000000000

seqnointegerquery

Block block seqno. Must be sent with workchain and shard.

start_utimeintegerquery

Query blocks with generation UTC timestamp after given timestamp.

end_utimeintegerquery

Query blocks with generation UTC timestamp before given timestamp

start_ltintegerquery

Query blocks with lt >= start_lt

end_ltintegerquery

Query blocks with lt <= end_lt

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringascdescdescquery

Sort results by UTC timestamp.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Blocks

curl -X GET 'https://ton.nownodes.io/blocks'

const response = await fetch('https://ton.nownodes.io/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/blocks')
data = response.json()

{
  "blocks": [
    {
      "workchain": 0,
      "shard": "string",
      "seqno": 0,
      "root_hash": "string",
      "file_hash": "string",
      "global_id": 0,
      "version": 0,
      "after_merge": true,
      "before_split": true,
      "after_split": true,
      "want_merge": true,
      "want_split": true,
      "key_block": true,
      "vert_seqno_incr": true,
      "flags": 0,
      "gen_utime": "string",
      "start_lt": "string",
      "end_lt": "string",
      "validator_list_hash_short": 0,
      "gen_catchain_seqno": 0,
      "min_ref_mc_seqno": 0,
      "prev_key_block_seqno": 0,
      "vert_seqno": 0,
      "master_ref_seqno": 0,
      "rand_seed": "string",
      "created_by": "string",
      "tx_count": 0,
      "masterchain_block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "prev_blocks": [
        {
          "workchain": 0,
          "shard": "string",
          "seqno": 0
        }
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Shards By Masterchain Block

GET

https://ton.nownodes.io/masterchainBlockShardState

Parameters

seqnointegerrequiredquery

Masterchain block seqno

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Shards By Masterchain Block

curl -X GET 'https://ton.nownodes.io/masterchainBlockShardState'

const response = await fetch('https://ton.nownodes.io/masterchainBlockShardState', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/masterchainBlockShardState')
data = response.json()

{
  "blocks": [
    {
      "workchain": 0,
      "shard": "string",
      "seqno": 0,
      "root_hash": "string",
      "file_hash": "string",
      "global_id": 0,
      "version": 0,
      "after_merge": true,
      "before_split": true,
      "after_split": true,
      "want_merge": true,
      "want_split": true,
      "key_block": true,
      "vert_seqno_incr": true,
      "flags": 0,
      "gen_utime": "string",
      "start_lt": "string",
      "end_lt": "string",
      "validator_list_hash_short": 0,
      "gen_catchain_seqno": 0,
      "min_ref_mc_seqno": 0,
      "prev_key_block_seqno": 0,
      "vert_seqno": 0,
      "master_ref_seqno": 0,
      "rand_seed": "string",
      "created_by": "string",
      "tx_count": 0,
      "masterchain_block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "prev_blocks": [
        {
          "workchain": 0,
          "shard": "string",
          "seqno": 0
        }
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Address Book

GET

https://ton.nownodes.io/addressBook

Returns an address book for given address list.

Parameters

addressArray<string>requiredquery

List of addresses in any form. Max: 1024

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Address Book

curl -X GET 'https://ton.nownodes.io/addressBook'

const response = await fetch('https://ton.nownodes.io/addressBook', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/addressBook')
data = response.json()

{}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Masterchain Block Shards

GET

https://ton.nownodes.io/masterchainBlockShards

Returns all worchain blocks, that appeared after previous masterchain block.

Note: this method is not equivalent with /api/v2/shards.

Parameters

seqnointegerrequiredquery

Masterchain block seqno

include_mc_blockbooleanfalsequery

Include masterchain block

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Masterchain Block Shards

curl -X GET 'https://ton.nownodes.io/masterchainBlockShards'

const response = await fetch('https://ton.nownodes.io/masterchainBlockShards', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/masterchainBlockShards')
data = response.json()

{
  "blocks": [
    {
      "workchain": 0,
      "shard": "string",
      "seqno": 0,
      "root_hash": "string",
      "file_hash": "string",
      "global_id": 0,
      "version": 0,
      "after_merge": true,
      "before_split": true,
      "after_split": true,
      "want_merge": true,
      "want_split": true,
      "key_block": true,
      "vert_seqno_incr": true,
      "flags": 0,
      "gen_utime": "string",
      "start_lt": "string",
      "end_lt": "string",
      "validator_list_hash_short": 0,
      "gen_catchain_seqno": 0,
      "min_ref_mc_seqno": 0,
      "prev_key_block_seqno": 0,
      "vert_seqno": 0,
      "master_ref_seqno": 0,
      "rand_seed": "string",
      "created_by": "string",
      "tx_count": 0,
      "masterchain_block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "prev_blocks": [
        {
          "workchain": 0,
          "shard": "string",
          "seqno": 0
        }
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Transactions

GET

https://ton.nownodes.io/transactions

Get transactions by specified filters.

Parameters

workchainintegerquery

Block workchain.

shardstringquery

Block shard id. Must be sent with workchain. Example: 8000000000000000

seqnointegerquery

Block block seqno. Must be sent with workchain and shard. Must be sent in hex form.

accountArray<string>query

List of account addresses to get transactions. Can be sent in hex, base64 or base64url form.

exclude_accountArray<string>query

Exclude transactions on specified account addresses

hashstringquery

Transaction hash. Acceptable in hex, base64 and base64url forms.

ltintegerquery

Transaction lt.

start_utimeintegerquery

Query transactions with generation UTC timestamp after given timestamp.

end_utimeintegerquery

Query transactions with generation UTC timestamp before given timestamp

start_ltintegerquery

Query transactions with lt >= start_lt

end_ltintegerquery

Query transactions with lt <= end_lt

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringascdescdescquery

Sort transactions by lt.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Transactions

curl -X GET 'https://ton.nownodes.io/transactions'

const response = await fetch('https://ton.nownodes.io/transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/transactions')
data = response.json()

{
  "transactions": [
    {
      "account": "string",
      "hash": "string",
      "lt": "string",
      "now": 0,
      "orig_status": "uninit",
      "end_status": "uninit",
      "total_fees": "string",
      "prev_trans_hash": "string",
      "prev_trans_lt": "string",
      "block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "in_msg": {
        "hash": "string",
        "source": "string",
        "destination": "string",
        "value": "string",
        "fwd_fee": "string",
        "ihr_fee": "string",
        "created_lt": "string",
        "created_at": "string",
        "opcode": "string",
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "import_fee": "string",
        "message_content": {
          "hash": "string",
          "body": "string",
          "decoded": {
            "type": "text_comment",
            "comment": "string"
          }
        },
        "init_state": {
          "hash": "string",
          "body": "string"
        }
      },
      "out_msgs": [
        {
          "hash": "string",
          "source": "string",
          "destination": "string",
          "value": "string",
          "fwd_fee": "string",
          "ihr_fee": "string",
          "created_lt": "string",
          "created_at": "string",
          "opcode": "string",
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "import_fee": "string",
          "message_content": {
            "hash": "string",
            "body": "string",
            "decoded": {
              "type": "text_comment",
              "comment": "string"
            }
          },
          "init_state": {
            "hash": "string",
            "body": "string"
          }
        }
      ],
      "account_state_before": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "account_state_after": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "mc_block_seqno": 0
    }
  ],
  "address_book": {}
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Transactions By Masterchain Block

GET

https://ton.nownodes.io/transactionsByMasterchainBlock

Returns transactions from masterchain block and from all shards.

Parameters

seqnointegerrequiredquery

Masterchain block seqno

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringnoneascdescdescquery

Sort transactions by lt.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Transactions By Masterchain Block

curl -X GET 'https://ton.nownodes.io/transactionsByMasterchainBlock'

const response = await fetch('https://ton.nownodes.io/transactionsByMasterchainBlock', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/transactionsByMasterchainBlock')
data = response.json()

{
  "transactions": [
    {
      "account": "string",
      "hash": "string",
      "lt": "string",
      "now": 0,
      "orig_status": "uninit",
      "end_status": "uninit",
      "total_fees": "string",
      "prev_trans_hash": "string",
      "prev_trans_lt": "string",
      "block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "in_msg": {
        "hash": "string",
        "source": "string",
        "destination": "string",
        "value": "string",
        "fwd_fee": "string",
        "ihr_fee": "string",
        "created_lt": "string",
        "created_at": "string",
        "opcode": "string",
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "import_fee": "string",
        "message_content": {
          "hash": "string",
          "body": "string",
          "decoded": {
            "type": "text_comment",
            "comment": "string"
          }
        },
        "init_state": {
          "hash": "string",
          "body": "string"
        }
      },
      "out_msgs": [
        {
          "hash": "string",
          "source": "string",
          "destination": "string",
          "value": "string",
          "fwd_fee": "string",
          "ihr_fee": "string",
          "created_lt": "string",
          "created_at": "string",
          "opcode": "string",
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "import_fee": "string",
          "message_content": {
            "hash": "string",
            "body": "string",
            "decoded": {
              "type": "text_comment",
              "comment": "string"
            }
          },
          "init_state": {
            "hash": "string",
            "body": "string"
          }
        }
      ],
      "account_state_before": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "account_state_after": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "mc_block_seqno": 0
    }
  ],
  "address_book": {}
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Transactions By Message

GET

https://ton.nownodes.io/transactionsByMessage

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

directionstringinoutrequiredquery

Message direction.

msg_hashstringrequiredquery

Message hash. Acceptable in hex, base64 and base64url forms.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Transactions By Message

curl -X GET 'https://ton.nownodes.io/transactionsByMessage'

const response = await fetch('https://ton.nownodes.io/transactionsByMessage', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/transactionsByMessage')
data = response.json()

{
  "transactions": [
    {
      "account": "string",
      "hash": "string",
      "lt": "string",
      "now": 0,
      "orig_status": "uninit",
      "end_status": "uninit",
      "total_fees": "string",
      "prev_trans_hash": "string",
      "prev_trans_lt": "string",
      "block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "in_msg": {
        "hash": "string",
        "source": "string",
        "destination": "string",
        "value": "string",
        "fwd_fee": "string",
        "ihr_fee": "string",
        "created_lt": "string",
        "created_at": "string",
        "opcode": "string",
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "import_fee": "string",
        "message_content": {
          "hash": "string",
          "body": "string",
          "decoded": {
            "type": "text_comment",
            "comment": "string"
          }
        },
        "init_state": {
          "hash": "string",
          "body": "string"
        }
      },
      "out_msgs": [
        {
          "hash": "string",
          "source": "string",
          "destination": "string",
          "value": "string",
          "fwd_fee": "string",
          "ihr_fee": "string",
          "created_lt": "string",
          "created_at": "string",
          "opcode": "string",
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "import_fee": "string",
          "message_content": {
            "hash": "string",
            "body": "string",
            "decoded": {
              "type": "text_comment",
              "comment": "string"
            }
          },
          "init_state": {
            "hash": "string",
            "body": "string"
          }
        }
      ],
      "account_state_before": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "account_state_after": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "mc_block_seqno": 0
    }
  ],
  "address_book": {}
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Adjacent Transactions

GET

https://ton.nownodes.io/adjacentTransactions

Get parent and/or children for specified transaction.

Parameters

hashstringrequiredquery

Transaction hash. Acceptable in hex, base64 and base64url forms.

directionstringinoutbothbothquery

Direction transactions by lt.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringnoneascdescdescquery

Sort transactions by lt.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Adjacent Transactions

curl -X GET 'https://ton.nownodes.io/adjacentTransactions'

const response = await fetch('https://ton.nownodes.io/adjacentTransactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/adjacentTransactions')
data = response.json()

{
  "transactions": [
    {
      "account": "string",
      "hash": "string",
      "lt": "string",
      "now": 0,
      "orig_status": "uninit",
      "end_status": "uninit",
      "total_fees": "string",
      "prev_trans_hash": "string",
      "prev_trans_lt": "string",
      "block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "in_msg": {
        "hash": "string",
        "source": "string",
        "destination": "string",
        "value": "string",
        "fwd_fee": "string",
        "ihr_fee": "string",
        "created_lt": "string",
        "created_at": "string",
        "opcode": "string",
        "ihr_disabled": true,
        "bounce": true,
        "bounced": true,
        "import_fee": "string",
        "message_content": {
          "hash": "string",
          "body": "string",
          "decoded": {
            "type": "text_comment",
            "comment": "string"
          }
        },
        "init_state": {
          "hash": "string",
          "body": "string"
        }
      },
      "out_msgs": [
        {
          "hash": "string",
          "source": "string",
          "destination": "string",
          "value": "string",
          "fwd_fee": "string",
          "ihr_fee": "string",
          "created_lt": "string",
          "created_at": "string",
          "opcode": "string",
          "ihr_disabled": true,
          "bounce": true,
          "bounced": true,
          "import_fee": "string",
          "message_content": {
            "hash": "string",
            "body": "string",
            "decoded": {
              "type": "text_comment",
              "comment": "string"
            }
          },
          "init_state": {
            "hash": "string",
            "body": "string"
          }
        }
      ],
      "account_state_before": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "account_state_after": {
        "hash": "string",
        "balance": "string",
        "account_status": "uninit",
        "frozen_hash": "string",
        "code_hash": "string",
        "data_hash": "string"
      },
      "mc_block_seqno": 0
    }
  ],
  "address_book": {}
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Messages

GET

https://ton.nownodes.io/messages

Get messages by specified filters.

Parameters

hashstringquery

Message hash. Acceptable in hex, base64 and base64url forms.

sourcestringquery

The source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.

destinationstringquery

The destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.

body_hashstringquery

Message body hash. Acceptable in hex, base64 and base64url forms.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Messages

curl -X GET 'https://ton.nownodes.io/messages'

const response = await fetch('https://ton.nownodes.io/messages', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/messages')
data = response.json()

{
  "messages": [
    {
      "hash": "string",
      "source": "string",
      "destination": "string",
      "value": "string",
      "fwd_fee": "string",
      "ihr_fee": "string",
      "created_lt": "string",
      "created_at": "string",
      "opcode": "string",
      "ihr_disabled": true,
      "bounce": true,
      "bounced": true,
      "import_fee": "string",
      "message_content": {
        "hash": "string",
        "body": "string",
        "decoded": {
          "type": "text_comment",
          "comment": "string"
        }
      },
      "init_state": {
        "hash": "string",
        "body": "string"
      }
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Nft Collections

GET

https://ton.nownodes.io/nft/collections

Get NFT collections.

Parameters

collection_addressstringquery

NFT collection address. Must be sent in hex, base64 and base64url forms.

owner_addressstringquery

Address of NFT collection owner. Must be sent in hex, base64 and base64url forms.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Nft Collections

curl -X GET 'https://ton.nownodes.io/nft/collections'

const response = await fetch('https://ton.nownodes.io/nft/collections', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/nft/collections')
data = response.json()

{
  "nft_collections": [
    {
      "address": "string",
      "owner_address": "string",
      "last_transaction_lt": "string",
      "next_item_index": "string",
      "code_hash": "string",
      "data_hash": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Nft Items

GET

https://ton.nownodes.io/nft/items

Get NFT items.

Parameters

addressstringquery

NFT address. Must be sent in hex, base64 and base64url forms.

owner_addressstringquery

Address of NFT owner. Must be sent in hex, base64 and base64url forms.

collection_addressstringquery

NFT collection address. Must be sent in hex, base64 and base64url forms.

indexstringquery

NFT Item index. Use it together with collection address.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Nft Items

curl -X GET 'https://ton.nownodes.io/nft/items'

const response = await fetch('https://ton.nownodes.io/nft/items', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/nft/items')
data = response.json()

{
  "nft_items": [
    {
      "address": "string",
      "collection_address": "string",
      "owner_address": "string",
      "init": true,
      "index": "string",
      "last_transaction_lt": "string",
      "code_hash": "string",
      "data_hash": "string",
      "collection": {
        "address": "string",
        "owner_address": "string",
        "last_transaction_lt": "string",
        "next_item_index": "string",
        "code_hash": "string",
        "data_hash": "string"
      }
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Nft Transfers

GET

https://ton.nownodes.io/nft/transfers

Get NFT transfers by specified filters.

Parameters

addressstringquery

Address of NFT owner. Must be sent in hex, base64 and base64url forms.

item_addressstringquery

NFT item address. Must be sent in hex, base64 and base64url forms.

collection_addressstringquery

NFT collection address. Must be sent in hex, base64 and base64url forms.

directionstringinoutbothbothquery

Direction transactions by lt.

start_utimeintegerquery

Query transactions with generation UTC timestamp after given timestamp.

end_utimeintegerquery

Query transactions with generation UTC timestamp before given timestamp

start_ltintegerquery

Query transactions with lt >= start_lt

end_ltintegerquery

Query transactions with lt <= end_lt

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringascdescdescquery

Sort transactions by lt.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Nft Transfers

curl -X GET 'https://ton.nownodes.io/nft/transfers'

const response = await fetch('https://ton.nownodes.io/nft/transfers', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/nft/transfers')
data = response.json()

{
  "nft_transfers": [
    {
      "query_id": "string",
      "nft_address": "string",
      "transaction_hash": "string",
      "transaction_lt": "string",
      "transaction_now": 0,
      "old_owner": "string",
      "new_owner": "string",
      "response_destination": "string",
      "custom_payload": "string",
      "forward_amount": "string",
      "forward_payload": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Jetton Masters

GET

https://ton.nownodes.io/jetton/masters

Get Jetton masters by specified filters.

Parameters

addressstringquery

Jetton Master address. Must be sent in hex, base64 and base64url forms.

admin_addressstringquery

Address of Jetton Masters admin. Must be sent in hex, base64 and base64url forms.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Jetton Masters

curl -X GET 'https://ton.nownodes.io/jetton/masters'

const response = await fetch('https://ton.nownodes.io/jetton/masters', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/jetton/masters')
data = response.json()

{
  "jetton_masters": [
    {
      "address": "string",
      "total_supply": "string",
      "mintable": true,
      "admin_address": "string",
      "last_transaction_lt": "string",
      "jetton_wallet_code_hash": "string",
      "code_hash": "string",
      "data_hash": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Jetton Wallets

GET

https://ton.nownodes.io/jetton/wallets

Get Jetton wallets by specified filters.

Parameters

addressstringquery

Jetton wallet address. Must be sent in hex, base64 and base64url forms.

owner_addressstringquery

Address of Jetton wallets owner. Must be sent in hex, base64 and base64url forms.

jetton_addressstringquery

Jetton Master. Must be sent in hex, base64 and base64url forms.

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Jetton Wallets

curl -X GET 'https://ton.nownodes.io/jetton/wallets'

const response = await fetch('https://ton.nownodes.io/jetton/wallets', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/jetton/wallets')
data = response.json()

{
  "jetton_wallets": [
    {
      "address": "string",
      "balance": "string",
      "owner": "string",
      "jetton": "string",
      "last_transaction_lt": "string",
      "code_hash": "string",
      "data_hash": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Jetton Transfers

GET

https://ton.nownodes.io/jetton/transfers

Get Jetton transfers by specified filters.

Parameters

addressstringquery

Account address. Must be sent in hex, base64 and base64url forms.

jetton_walletstringquery

Jetton wallet address. Must be sent in hex, base64 and base64url forms.

jetton_masterstringquery

Jetton master address. Must be sent in hex, base64 and base64url forms.

directionstringinoutbothbothquery

Direction transactions by lt.

start_utimeintegerquery

Query transactions with generation UTC timestamp after given timestamp.

end_utimeintegerquery

Query transactions with generation UTC timestamp before given timestamp

start_ltintegerquery

Query transactions with lt >= start_lt

end_ltintegerquery

Query transactions with lt <= end_lt

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringnoneascdescdescquery

Sort transactions by lt.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Jetton Transfers

curl -X GET 'https://ton.nownodes.io/jetton/transfers'

const response = await fetch('https://ton.nownodes.io/jetton/transfers', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/jetton/transfers')
data = response.json()

{
  "jetton_transfers": [
    {
      "query_id": "string",
      "source": "string",
      "destination": "string",
      "amount": "string",
      "source_wallet": "string",
      "jetton_master": "string",
      "transaction_hash": "string",
      "transaction_lt": "string",
      "transaction_now": 0,
      "response_destination": "string",
      "custom_payload": "string",
      "forward_ton_amount": "string",
      "forward_payload": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Jetton Burns

GET

https://ton.nownodes.io/jetton/burns

Get Jetton burns by specified filters.

Parameters

addressstringquery

Account address. Must be sent in hex, base64 and base64url forms.

jetton_walletstringquery

Jetton wallet address. Must be sent in hex, base64 and base64url forms.

jetton_masterstringquery

Jetton master address. Must be sent in hex, base64 and base64url forms.

start_utimeintegerquery

Query transactions with generation UTC timestamp after given timestamp.

end_utimeintegerquery

Query transactions with generation UTC timestamp before given timestamp

start_ltintegerquery

Query transactions with lt >= start_lt

end_ltintegerquery

Query transactions with lt <= end_lt

limitinteger[1, 256]128query

Limit number of queried rows. Use with offset to batch read.

offsetinteger>= 00query

Skip first N rows. Use with limit to batch read.

sortstringascdescdescquery

Sort transactions by lt.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Jetton Burns

curl -X GET 'https://ton.nownodes.io/jetton/burns'

const response = await fetch('https://ton.nownodes.io/jetton/burns', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/jetton/burns')
data = response.json()

{
  "jetton_burns": [
    {
      "query_id": "string",
      "owner": "string",
      "jetton_master": "string",
      "transaction_hash": "string",
      "transaction_lt": "string",
      "transaction_now": 0,
      "response_destination": "string",
      "custom_payload": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Send Message

POST

https://ton.nownodes.io/message

Send external message to TON network.

Body

application/json

Message in boc base64 format.

Message in base64 boc serialized format.

bocstringrequired

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Send Message

curl -X POST 'https://ton.nownodes.io/message' \
  -H 'Content-Type: application/json' \
  -d '{
    "boc": [
      "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
    ]
  }'

const response = await fetch('https://ton.nownodes.io/message', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "boc": [
        "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "boc": [
    "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  ]
}

response = requests.post('https://ton.nownodes.io/message', json=payload)
data = response.json()

Request Body

{
  "boc": [
    "te6ccgECBQEAARUAAkWIAWTtae+KgtbrX26Bep8JSq8lFLfGOoyGR/xwdjfvpvEaHg"
  ]
}

{
  "message_hash": [
    "383E348617141E35BC25ED9CD0EDEC2A4EAF6413948BF1FB7F865CEFE8C2CD44"
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Run Get Method

POST

https://ton.nownodes.io/runGetMethod

Run get method of smart contract. Stack supports only num, cell and slice types:

Copied!

[
    {
        "type": "num",
        "value": "0x12a"
    },
    {
        "type": "cell",
        "value": "te6..." // base64 encoded boc with cell
    },
    {
        "type": "slice",
        "value": "te6..." // base64 encoded boc with slice
    }
]

Body

application/json

RunGetMethod request body

any

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Run Get Method

curl -X POST 'https://ton.nownodes.io/runGetMethod' \
  -H 'Content-Type: application/json'

const response = await fetch('https://ton.nownodes.io/runGetMethod', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
});

const data = await response.json();

import requests

response = requests.post('https://ton.nownodes.io/runGetMethod', headers={'Content-Type': 'application/json'})
data = response.json()

422

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Estimate Fee

POST

https://ton.nownodes.io/estimateFee

Estimate fee for external message.

Body

application/json

EstimateFee request body

addressstringrequired

bodystringrequired

init_codestring

init_datastring

ignore_chksigbooleantrue

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Estimate Fee

curl -X POST 'https://ton.nownodes.io/estimateFee' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "string",
    "body": "string",
    "init_code": "string",
    "init_data": "string",
    "ignore_chksig": true
  }'

const response = await fetch('https://ton.nownodes.io/estimateFee', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "string",
      "body": "string",
      "init_code": "string",
      "init_data": "string",
      "ignore_chksig": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "string",
  "body": "string",
  "init_code": "string",
  "init_data": "string",
  "ignore_chksig": True
}

response = requests.post('https://ton.nownodes.io/estimateFee', json=payload)
data = response.json()

Request Body

{
  "address": "string",
  "body": "string",
  "init_code": "string",
  "init_data": "string",
  "ignore_chksig": true
}

{
  "source_fees": {
    "in_fwd_fee": 0,
    "storage_fee": 0,
    "gas_fee": 0,
    "fwd_fee": 0
  },
  "destination_fees": [
    {
      "in_fwd_fee": 0,
      "storage_fee": 0,
      "gas_fee": 0,
      "fwd_fee": 0
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Account Information

GET

https://ton.nownodes.io/account

Get smart contract information.

Parameters

addressstringrequiredquery

Account address. Can be sent in raw or user-friendly form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Account Information

curl -X GET 'https://ton.nownodes.io/account'

const response = await fetch('https://ton.nownodes.io/account', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/account')
data = response.json()

{
  "balance": "string",
  "code": "string",
  "data": "string",
  "last_transaction_lt": "string",
  "last_transaction_hash": "string",
  "frozen_hash": "string",
  "status": "uninit"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Wallet Information

GET

https://ton.nownodes.io/wallet

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

addressstringrequiredquery

Smart contract address. Can be sent in raw or user-friendly form.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Wallet Information

curl -X GET 'https://ton.nownodes.io/wallet'

const response = await fetch('https://ton.nownodes.io/wallet', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton.nownodes.io/wallet')
data = response.json()

{
  "balance": "string",
  "wallet_type": "string",
  "seqno": 0,
  "wallet_id": 0,
  "last_transaction_lt": "string",
  "last_transaction_hash": "string",
  "status": "uninit"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Documentation

Authentication

TON HTTP API

API V1 Reference

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

Body