Docs
Поиск⌘ K
  • Главная страница
  • О The Graph
  • Поддерживаемые сети
  • Protocol Contracts
  • Субграфы
    • Субпотоки
      • Token API
        • Hypergraph
          • AI Suite
            • Индексирование
              • Ресурсы
                Token API > evm-nfts

                NFT Ownerships by Address

                GET/v1/evm/nft/ownerships

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

                Параметры запроса

                ParameterОписаниеValue
                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.

                  Required
                  contract
                  string

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

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

                        СтатусОписание
                        200

                        Successful Response

                        400

                        Client side error

                        401

                        Authentication failed

                        403

                        Forbidden

                        404

                        Not found

                        500

                        Server side error

                        ⁠Редактировать на 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&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 GraphСтатусТестовая сетьБрундовые ресурсыФорумБезопасностьПолитика конфиденциальностиУсловия обслуживания