Skip to main content
GET
/
api
/
v3
/
nft
/
items
Get NFT items
curl --request GET \
  --url https://toncenter.com/api/v3/nft/items
{
  "address_book": {},
  "metadata": {},
  "nft_items": [
    {
      "address": "<string>",
      "auction_contract_address": "<string>",
      "code_hash": "<string>",
      "collection": {
        "address": "<string>",
        "code_hash": "<string>",
        "collection_content": {},
        "data_hash": "<string>",
        "last_transaction_lt": "0",
        "next_item_index": "<string>",
        "owner_address": "<string>"
      },
      "collection_address": "<string>",
      "content": {},
      "data_hash": "<string>",
      "index": "<string>",
      "init": true,
      "last_transaction_lt": "0",
      "on_sale": true,
      "owner_address": "<string>",
      "real_owner": "<string>",
      "sale_contract_address": "<string>"
    }
  ]
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

ADDRESS = ["EQAMrsze7MaG_7P2ENd1eeT-S2VttJ1myT9sX5f-F1gY7xGx"]


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v3.nfts.get_nft_items(
            address=ADDRESS,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

​
address
string[]

NFT item address in any form. Max: 1000.

​
owner_address
string[]

Address of NFT item owner in any form. Max: 1000.

​
collection_address
string[]

Collection address in any form.

​
index
string[]

Index of item for given collection. Max: 1000.

​
include_on_sale
boolean
default:false

Include nft on sales and auctions. Used only when owner_address is passed

​
sort_by_last_transaction_lt
boolean

Sort NFT items by last transaction lt descending. Warning: results may be inconsistent during pagination with limit and offset.

​
limit
integer
default:10

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

​
offset
integer
default:0

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

Response

OK

​
address_book
object
​
metadata
object
​
nft_items
object[]