Docs
⌘ K

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.

    		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

          StatusDescription
          200

          Successful Response

          400

          Client side error

          401

          Authentication failed

          403

          Forbidden

          404

          Not found

          500

          Server side error