API V1 Reference

Get Address Information

get

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

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getAddressInformation

GET /getAddressInformation?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Extended Address Information

get

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.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getExtendedAddressInformation

GET /getExtendedAddressInformation?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Wallet Information

get

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

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getWalletInformation

GET /getWalletInformation?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Transactions

get

Get transaction history of a given address.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

limitinteger · max: 100Optional

Maximum number of transactions in response.

Default: 10

ltintegerOptional

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

hashstringOptional

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

to_ltintegerOptional

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

Default: 0

archivalbooleanOptional

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

Default: false

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getTransactions

GET /getTransactions?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Address Balance

get

Get balance (in nanotons) of a given address.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getAddressBalance

GET /getAddressBalance?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Address

get

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

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getAddressState

GET /getAddressState?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Pack Address

get

Convert an address from raw to human-readable format.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in raw form.

Example: 0:83DFD552E63729B472FCBCC8C45EBCC6691702558B68EC7527E1BA403A0F31A8

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/packAddress

GET /packAddress?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Unpack Address

get

Convert an address from human-readable to raw format.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in user-friendly form

Example: EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/unpackAddress

GET /unpackAddress?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Masterchain Info

get

Get up-to-date masterchain state.

Authorizations

api-keystringRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getMasterchainInfo

GET /getMasterchainInfo HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Masterchain Block Signatures

get

Get up-to-date masterchain state.

Authorizations

api-keystringRequired

Query parameters

seqnointegerRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getMasterchainBlockSignatures

GET /getMasterchainBlockSignatures?seqno=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Shard Block Proof

get

Get merkle proof of shardchain block.

Authorizations

api-keystringRequired

Query parameters

workchainintegerRequired

Block workchain id

shardintegerRequired

Block shard id

seqnointegerRequired

Block seqno

from_seqnointegerOptional

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

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getShardBlockProof

GET /getShardBlockProof?workchain=1&shard=1&seqno=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Consensus Block

get

Get consensus block and its update timestamp.

Authorizations

api-keystringRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getConsensusBlock

GET /getConsensusBlock HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Lookup Block

get

Look up block by either seqno, lt or unixtime.

Authorizations

api-keystringRequired

Query parameters

workchainintegerRequired

Workchain id to look up block in

shardintegerRequired

Shard id to look up block in

seqnointegerOptional

Block's height

ltintegerOptional

Block's logical time

unixtimeintegerOptional

Block's unixtime

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/lookupBlock

GET /lookupBlock?workchain=1&shard=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Shards

get

Get shards information.

Authorizations

api-keystringRequired

Query parameters

seqnointegerRequired

Masterchain seqno to fetch shards of.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/shards

GET /shards?seqno=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Block Transactions

get

Get transactions of the given block.

Authorizations

api-keystringRequired

Query parameters

workchainintegerRequired

shardintegerRequired

seqnointegerRequired

root_hashstringOptional

file_hashstringOptional

after_ltintegerOptional

after_hashstringOptional

countintegerOptionalDefault: 40

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getBlockTransactions

GET /getBlockTransactions?workchain=1&shard=1&seqno=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Block Transactions Ext

get

Get transactions of the given block.

Authorizations

api-keystringRequired

Query parameters

workchainintegerRequired

shardintegerRequired

seqnointegerRequired

root_hashstringOptional

file_hashstringOptional

after_ltintegerOptional

after_hashstringOptional

countintegerOptionalDefault: 40

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getBlockTransactionsExt

GET /getBlockTransactionsExt?workchain=1&shard=1&seqno=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Block Header

get

Get metadata of a given block.

Authorizations

api-keystringRequired

Query parameters

workchainintegerRequired

shardintegerRequired

seqnointegerRequired

root_hashstringOptional

file_hashstringOptional

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getBlockHeader

GET /getBlockHeader?workchain=1&shard=1&seqno=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Config Param

get

Get config by id.

Authorizations

api-keystringRequired

Query parameters

config_idintegerRequired

Config id

seqnointegerOptional

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

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getConfigParam

GET /getConfigParam?config_id=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Config All

get

Get cell with full config.

Authorizations

api-keystringRequired

Query parameters

seqnointegerOptional

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

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getConfigAll

GET /getConfigAll HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Out Msg Queue Sizes

get

Get info with current sizes of messages queues by shards.

Authorizations

api-keystringRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getOutMsgQueueSizes

GET /getOutMsgQueueSizes HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Token Data

get

Get NFT or Jetton information.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

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

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/getTokenData

GET /getTokenData?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Try Locate Tx

get

Locate outcoming transaction of destination address by incoming message.

Authorizations

api-keystringRequired

Query parameters

sourcestringRequired

destinationstringRequired

created_ltintegerRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/tryLocateTx

GET /tryLocateTx?source=text&destination=text&created_lt=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Try Locate Result Tx

get

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

Authorizations

api-keystringRequired

Query parameters

sourcestringRequired

destinationstringRequired

created_ltintegerRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/tryLocateResultTx

GET /tryLocateResultTx?source=text&destination=text&created_lt=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Get Try Locate Source Tx

get

Locate incoming transaction of source address by outcoming message.

Authorizations

api-keystringRequired

Query parameters

sourcestringRequired

destinationstringRequired

created_ltintegerRequired

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/tryLocateSourceTx

GET /tryLocateSourceTx?source=text&destination=text&created_lt=1 HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Detect Address

get

Get all possible address forms.

Authorizations

api-keystringRequired

Query parameters

addressstringRequired

Identifier of target TON account in any form.

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

get

/detectAddress

GET /detectAddress?address=text HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Send Boc

post

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

Authorizations

api-keystringRequired

Body

bocstringRequired

b64 encoded bag of cells

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

post

/sendBoc

POST /sendBoc HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "boc": "text"
}

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Send Boc Return Hash

post

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

Authorizations

api-keystringRequired

Body

bocstringRequired

b64 encoded bag of cells

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

post

/sendBocReturnHash

POST /sendBocReturnHash HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "boc": "text"
}

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Send Query

post

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.

Authorizations

api-keystringRequired

Body

addressstringRequired

Address in any format

bodystringRequired

b64-encoded boc-serialized cell with message body

init_codestringOptional

b64-encoded boc-serialized cell with init-code

Default: ""

init_datastringOptional

b64-encoded boc-serialized cell with init-data

Default: ""

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

post

/sendQuery

POST /sendQuery HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 62

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

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Estimate Fee

post

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

Authorizations

api-keystringRequired

Body

addressstringRequired

Address in any format

bodystringRequired

b64-encoded cell with message body

init_codestringOptional

b64-encoded cell with init-code

Default: ""

init_datastringOptional

b64-encoded cell with init-data

Default: ""

ignore_chksigbooleanOptional

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

Default: true

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

post

/estimateFee

POST /estimateFee HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 83

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

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Run Get Method

post

Run get method on smart contract.

Authorizations

api-keystringRequired

Body

addressstringRequired

Contract address

methodany ofRequired

Method name or method id

stringOptional

integerOptional

seqnointegerOptional

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

Responses

200

Successful Response

application/json

okbooleanRequired

resultany ofOptional

stringOptional

objectOptional

errorstringOptional

codeintegerOptional

422

Validation Error

504

Lite Server Timeout

post

/runGetMethod

POST /runGetMethod HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "address": "text",
  "method": "text",
  "stack": [
    []
  ],
  "seqno": 1
}

{
  "ok": true,
  "result": "text",
  "error": "text",
  "code": 1
}

Jsonrpc Handler

post

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

Authorizations

api-keystringRequired

Body

methodstringRequired

paramsobject · ParamsOptionalDefault: {}

idstringOptional

jsonrpcstringOptional

Responses

200

Successful Response

application/json

okbooleanRequired

resultanyOptional

errorstringOptional

codeintegerOptional

idstringRequired

jsonrpcstringOptionalDefault: 2.0

422

Validation Error

504

Lite Server Timeout

post

/jsonRPC

POST /jsonRPC HTTP/1.1
Host: ton.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 58

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

{
  "ok": true,
  "result": null,
  "error": "text",
  "code": 1,
  "id": "text",
  "jsonrpc": "2.0"
}

PreviousToncoin (TON)NextAPI V2 Reference

Last updated 4 months ago

hashtagGet Address Information

hashtagGet Extended Address Information

hashtagGet Wallet Information

hashtagGet Transactions

hashtagGet Address Balance

hashtagGet Address

hashtagPack Address

hashtagUnpack Address

hashtagGet Masterchain Info

hashtagGet Masterchain Block Signatures

hashtagGet Shard Block Proof

hashtagGet Consensus Block

hashtagLookup Block

hashtagGet Shards

hashtagGet Block Transactions

hashtagGet Block Transactions Ext

hashtagGet Block Header

hashtagGet Config Param

hashtagGet Config All

hashtagGet Out Msg Queue Sizes

hashtagGet Token Data

hashtagGet Try Locate Tx

hashtagGet Try Locate Result Tx

hashtagGet Try Locate Source Tx

hashtagDetect Address

hashtagSend Boc

hashtagSend Boc Return Hash

hashtagSend Query

hashtagEstimate Fee

hashtagRun Get Method

hashtagJsonrpc Handler

Get Address Information

Get Extended Address Information

Get Wallet Information

Get Transactions

Get Address Balance

Get Address

Pack Address

Unpack Address

Get Masterchain Info

Get Masterchain Block Signatures

Get Shard Block Proof

Get Consensus Block

Lookup Block

Get Shards

Get Block Transactions

Get Block Transactions Ext

Get Block Header

Get Config Param

Get Config All

Get Out Msg Queue Sizes

Get Token Data

Get Try Locate Tx

Get Try Locate Result Tx

Get Try Locate Source Tx

Detect Address

Send Boc

Send Boc Return Hash

Send Query

Estimate Fee

Run Get Method

Jsonrpc Handler