Skip to main content
GET
/
v2
/
accounts
/
{account_id}
/
nfts
cURL
curl --request GET \
  --url https://tonapi.io/v2/accounts/{account_id}/nfts
{
  "nft_items": [
    {
      "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
      "index": 58,
      "verified": true,
      "metadata": {},
      "approved_by": [
        "getgems"
      ],
      "trust": "whitelist",
      "owner": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "is_scam": true,
        "is_wallet": true,
        "name": "Ton foundation",
        "icon": "https://ton.org/logo.png"
      },
      "collection": {
        "address": "0:E93E7D444180608B8520C00DC664383A387356FB6E16FDDF99DBE5E1415A574B",
        "name": "TON Diamonds",
        "description": "Best collection in TON network"
      },
      "sale": {
        "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
        "market": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "is_scam": true,
          "is_wallet": true,
          "name": "Ton foundation",
          "icon": "https://ton.org/logo.png"
        },
        "price": {
          "currency_type": "jetton",
          "value": "123000000000",
          "decimals": 9,
          "token_name": "TON",
          "verification": "whitelist",
          "image": "https://cache.tonapi.io/images/jetton.jpg",
          "jetton": "0:0BB5A9F69043EEBDDA5AD2E946EB953242BD8F603FE795D90698CEEC6BFC60A0"
        },
        "owner": {
          "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
          "is_scam": true,
          "is_wallet": true,
          "name": "Ton foundation",
          "icon": "https://ton.org/logo.png"
        }
      },
      "previews": [
        {
          "resolution": "100x100",
          "url": "https://site.com/pic1.jpg"
        }
      ],
      "dns": "crypto.ton",
      "include_cnft": false,
      "code_hash": "<string>",
      "data_hash": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://tonapi.ness.su/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
account_id
string<address>
required

account ID

Example:

"0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"

Query Parameters

​
collection
string<address>

nft collection

Example:

"0:06d811f426598591b32b2c49f29f66c821368e4acb1de16762b04e0174532465"

​
limit
integer
default:1000
Required range: 1 <= x <= 1000
​
offset
integer
default:0
Required range: x >= 0
​
indirect_ownership
boolean
default:false

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

Response

account nft items

​
nft_items
object[]
required