Docs
搜索⌘ K
  • 主页
  • 关于 The Graph
  • 支持的网络
  • 协议合约
  • 子图
    • 子流
      • 代币 API
        • Hypergraph
          • AI Suite
            • 索引
              • Graph Horizon
                • 资源
                  代币 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.

                  查询参数

                  参数描述值
                  network
                  string

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

                  • 可选值: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                  必填
                  mainnet
                  address
                  string

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

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

                        • 可选值: ERC721, ERC1155
                        include_null_balances
                        boolean

                        Include zero/null balances in results

                          limit
                          integer

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

                          • 默认值: 10
                          • 最小值: 1
                          • 最大值: 1000
                          page
                          integer

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

                          • 默认值: 1
                          • 最小值: 1
                          • 最大值: 767465558638

                          可能的反应

                          状态描述
                          200

                          Successful Response

                          400

                          Client side error

                          401

                          Authentication failed

                          403

                          Forbidden

                          404

                          Not found

                          500

                          Server side error

                          ⁠在GitHub上编辑⁠

                          NFT ItemsNFT Sales
                          测试此终点

                          1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/nft/ownerships?network=mainnet&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&contract=0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3&token_id=12&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 AssetsForum安全Privacy PolicyTerms of Service