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>"
    }
  ]
}

Documentation Index

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

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

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[]