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 Ownerships by Address

                  GET/v1/evm/nft/ownerships

                  Returns NFT tokens owned by a wallet address with metadata and ownership information.

                  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
                  address
                  string

                  Filter by address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

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

                  Filter by contract address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

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

                  Token ID
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                    token_standard
                    string

                    Token standard

                    • Accepted values: ERC721, ERC1155
                    ERC721
                    include_null_balances
                    boolean

                    Include zero/null balances in results

                      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⁠

                      NFT ItemsNFT Sales
                      Test this endpoint

                      1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/nft/ownerships?network=mainnet&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&contract=0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3&token_id=12&token_standard=ERC721&include_null_balances=false&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                      1{2  "data": [3    {4      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",5      "contract": "0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3",6      "token_id": "12",7      "token_standard": "ERC721",8      "name": "Bored Ape Nike Club",9      "symbol": "BANC",10      "network": "mainnet"11    }12  ]13}
                      The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service