Skip to main content
GET
/
api
/
v3
/
nft
/
collections
Get NFT collections
curl --request GET \
  --url https://toncenter.com/api/v3/nft/collections
{
  "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>"
    }
  ]
}

SDK Usage

import asyncio

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

COLLECTION_ADDRESS = ["EQC3dNlesgVD8YbAazcauIrXBPfiVhMMr5YYk2in0Mtsz0Bz"]


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


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

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