Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • Resources
                  Token API > EVM NFT Endpoints

                  NFT Collection

                  GET/v1/evm/nft/collections

                  Returns NFT collection metadata, supply stats, owner count, and transfer history.

                  Query Parameters

                  ParameterDescriptionValue
                  network
                  string

                  The Graph Network ID for EVM networks https://thegraph.com/networks

                  • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                  Required
                  mainnet
                  contract
                  string

                  Filter by contract address

                  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
                  • Format: evm-address
                  Required
                  limit
                  integer

                  Number of items* returned in a single request.
                  *Plan restricted.

                  • Default value: 10
                  • Minimum value: 1
                  • Maximum value: 1000
                  page
                  integer

                  Page number to fetch.
                  Empty data array signifies end of results.

                  • Default value: 1
                  • Minimum value: 1
                  • Maximum value: 767465558638

                  Potential Responses

                  StatusDescription
                  200

                  Successful Response

                  400

                  Client side error

                  401

                  Authentication failed

                  403

                  Forbidden

                  404

                  Not found

                  500

                  Server side error

                  ⁠Edit on GitHub⁠

                  Swap EventsNFT Holders
                  Test this endpoint

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/nft/collections?network=mainnet&contract=0xbd3531da5cf5857e7cfaa92426877b022e612cf8&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "contract_creation": "2021-07-22 12:26:01",5      "contract_creator": "0xe9da256a28630efdc637bfd4c65f0887be1aeda8",6      "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",7      "name": "PudgyPenguins",8      "symbol": "PPG",9      "token_standard": "ERC721",10      "owners": 4952,11      "total_supply": 8888,12      "total_unique_supply": 8888,13      "total_transfers": 193641,14      "network": "mainnet"15    }16  ]17}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service