Get NFT collections

Returns NFT collection contracts matching the specified filters. Filter by collection address or owner address. Each result includes collection content metadata, next item index, and owner.

GET /api/v3/nft/collections

Get NFT collections

cURL

curl --request GET \
  --url https://toncenter.com/api/v3/nft/collections

200

{
  "address_book": {},
  "metadata": {},
  "nft_collections": [
    {
      "address": "<string>",
      "code_hash": "<string>",
      "collection_content": {},
      "data_hash": "<string>",
      "last_transaction_lt": "0",
      "next_item_index": "<string>",
      "owner_address": "<string>"
    }
  ]
}

Query Parameters

collection_address · string[]

Collection address in any form. Max: 1024.

owner_address · string[]

Address of collection owner in any form. Max: 1024.

limit · integer<int32> · default: 10

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

Required range: 1 <= x <= 1000

offset · integer<int32> · default: 0

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

Required range: x >= 0

Response

200 - application/json

Matching NFT collection contracts with address book and metadata.

Response wrapper containing NFT collections with address book and token metadata.

address_book · object

Address book mapping raw addresses to user-friendly forms for all addresses referenced in the response.

Show child attributes

metadata · object

Token and indexing metadata for all addresses referenced in the response.

Show child attributes

nft_collections · object[]

Array of NFT collections matching the query filters.

Show child attributes