Skip to main content

API Types

High availability blockchain APIs are the core element of secure, convenient and fast development of useful applications on TON.

  • TON Center API — fast and reliable HTTP API for The Open Network. Being based on tonlib, it allows to get all information about accounts, transactions and blocks.
  • TON HTTP API — API that allows to work with the indexed blockchain information.
  • TON ADNL API — secure API to communicate with TON, based on ADNL protocol.

Third party APIs

  • ton-api-v4 - another lite-api focused on speed via aggressive cashing in CDN.
  • tonapi.io - fast indexed API which provides basic data about accounts, transactions, blocks, application-specific data about NFT, Auctions, Jettons, TON DNS, Subscriptions. It also provides annotated data on transaction chains.
  • dton.io - GraphQL API with that can provide data about accounts, transactions and blocks, as well as application-specific data about NFT, Auctions, Jettons and TON DNS.
  • evercloud.dev - GraphQL API for basic queries in TON.
  • everspace.center - Simple RPC API for accessing TON Blockchain.

Examples

API for current Toncoin value

Convert Address into Raw and Friendly forms

info

It is preferable to convert address via local algorithm, read more in the Addresses section of documentation.

From Friendly to Raw form

/api/v2/unpackAddress

Curl

curl -X 'GET' \
'https://toncenter.com/api/v2/unpackAddress?address=EQApAj3rEnJJSxEjEHVKrH3QZgto_MQMOmk8l72azaXlY1zB' \
-H 'accept: application/json'

Response body

{
"ok": true,
"result": "0:29023deb1272494b112310754aac7dd0660b68fcc40c3a693c97bd9acda5e563"
}

From Friendly to Raw form

/api/v2/packAddress

Curl

curl -X 'GET' \
'https://toncenter.com/api/v2/packAddress?address=0%3A29023deb1272494b112310754aac7dd0660b68fcc40c3a693c97bd9acda5e563' \
-H 'accept: application/json'

Response body

{
"ok": true,
"result": "EQApAj3rEnJJSxEjEHVKrH3QZgto/MQMOmk8l72azaXlY1zB"
}

Retrieve data for the Wallet Smart Contract

Toncenter

curl

curl -X 'GET' \
'https://toncenter.com/api/v2/getWalletInformation?address=EQApAj3rEnJJSxEjEHVKrH3QZgto%2FMQMOmk8l72azaXlY1zB' \
-H 'accept: application/json'

Response Body

{
"ok": true,
"result": {
"wallet": true,
"balance": "2220156241",
"account_state": "active",
"wallet_type": "wallet v4 r2",
"seqno": 3,
"last_transaction_id": {
"@type": "internal.transactionId",
"lt": "35169513000005",
"hash": "3XPXsQ+3WGE+HlhNQYqglMR6ushMEycJJPpV0zn1NIY="
},
"wallet_id": 698983191
}
}

Tonapi

curl

curl -X 'GET' \
'https://tonapi.io/v2/accounts/0%3A29023deb1272494b112310754aac7dd0660b68fcc40c3a693c97bd9acda5e563' \
-H 'accept: application/json'

Response Body

{
"address": "0:29023deb1272494b112310754aac7dd0660b68fcc40c3a693c97bd9acda5e563",
"balance": 2220156241,
"last_activity": 1675978478,
"status": "active",
"interfaces": [
"wallet_v4r2",
"wallet_v4",
"wallet"
],
"name": "nft-recycle.ton",
"is_scam": false,
"memo_required": false,
"get_methods": []
}

NFT

Retrieve all NFT items by owner address

GET /v2/accounts/{account_id}/nfts

curl

curl -X 'GET' \
'https://tonapi.io/v2/accounts/EQCjk1hh952vWaE9bRguFkAhDAL5jj3xj9p0uPWrFBq_GEMS/nfts?limit=1000&offset=0&indirect_ownership=false' \
-H 'accept: application/json'
{
"nft_items": [
{
"address": "0:1bfa1550d1031186a8d7c90ea9ddab3d4fecb9f64e80e087d2b9305cbc06314b",
"index": 163,
"owner": {
"address": "0:a3935861f79daf59a13d6d182e1640210c02f98e3df18fda74b8f5ab141abf18",
"name": "Getgems Marketplace",
"is_scam": false
},
"collection": {
"address": "0:fc3b095b41ee438d0144e727657a6a3be207b2ff4d95f26874289e82c26fd835",
"name": ""
},
"verified": true,
"metadata": {
"name": "Solarbird #163",
"image": "https://s.getgems.io/nft/b/c/62cd827425200ebb6a9acb47/163/image.png",
"attributes": [
],
"description": "Cool bird for the cool holder"
},
"previews": [
{
"resolution": "100x100",
"url": "https://cache.tonapi.io/imgproxy/2UPH1P-oniVot8ea6nnoz-Foq4JivCHBvhufPJw5QEU/rs:fill:100:100:1/g:no/aHR0cHM6Ly9zLmdldGdlbXMuaW8vbmZ0L2IvYy82MmNkODI3NDI1MjAwZWJiNmE5YWNiNDcvMTYzL2ltYWdlLnBuZw.webp"
}
],
"approved_by": []
}
]
}

Jetton

Retrieve jetton metadata by jetton master address

GET /v2/jettons/{account_id}

curl

curl -X 'GET' \
'https://tonapi.io/v2/jettons/0%3A729c13b6df2c07cbf0a06ab63d34af454f3d320ec1bcd8fb5c6d24d0806a17c2' \
-H 'accept: application/json'
{
"mintable": true,
"total_supply": "100810730032",
"metadata": {
"address": "0:729c13b6df2c07cbf0a06ab63d34af454f3d320ec1bcd8fb5c6d24d0806a17c2",
"name": "jUSDT",
"symbol": "jUSDT",
"decimals": "6",
"image": "https://bridge.ton.org/token/1/0xdac17f958d2ee523a2206206994597c13d831ec7.png",
"description": "USDT transferred from Ethereum via bridge.ton.org. Token address in Ethereum: 0xdAC17F958D2ee523a2206206994597C13D831ec7"
},
"verification": "whitelist"
}

Retrieve all Jettons balances by owner's wallet address (account)

GET /v2/accounts/{account_id}/jettons

curl

curl -X 'GET' \
'https://tonapi.io/v2/accounts/0%3A408da3b28b6c065a593e10391269baaa9c5f8caebc0c69d9f0aabbab2a99256b/jettons' \
-H 'accept: application/json'
{
"balances": [
{
"balance": "10000000000",
"wallet_address": {
"address": "0:83add688b3517ee478dc7defecc76ca24add7a7f008f46ec0e88cc381f37230d",
"is_scam": false
},
"jetton": {
"address": "0:65aac9b5e380eae928db3c8e238d9bc0d61a9320fdc2bc7a2f6c87d6fedf9208",
"name": "Scaleton",
"symbol": "SCALE",
"decimals": 9,
"image": "https://cache.tonapi.io/imgproxy/jHx0m3tMBFj9z9vLy1cooH_v8DIi_2Zi43RLxyfga3g/rs:fill:200:200:1/g:no/aXBmczovL1FtU01pWHNaWU1lZndyVFEzUDZIbkRRYUNwZWNTNEVXTHBnS0s1RVgxRzhpQTg.webp",
"verification": "whitelist"
}
}
]
}

See Also