Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
addresses

List NFTs owned by an address grouped by collection/project

Retrieves NFTs owned by a specific address, organized by collection. Useful for displaying an address's NFT portfolio grouped by project.

get/{chain_id}/api/v2/addresses/{address_hash_param}/nft/collections

Path parameters

address_hash_paramstring required

Address hash in the path

chain_idstring required

The ID of the blockchain

Query parameters

string
OR
string

Filter by token type. Comma-separated list of:

  • ERC-721 - Non-fungible tokens
  • ERC-1155 - Multi-token standard
  • ERC-404 - Hybrid fungible/non-fungible tokens

Example: ERC-721,ERC-1155 to show both NFT and multi-token transfers

items_countinteger

Number of items per page

token_contract_address_hashstring

Token contract address hash for paging

token_type'ERC-20' | 'ERC-721' | 'ERC-1155' | 'ERC-404' | 'ERC-7984'

Token type for paging

Response

NFTs owned by the specified address, grouped by collection, with pagination.

next_page_paramsobject nullable required

Example response

{
  "items": [
    {
      "token": {
        "icon_url": "https://example.com"
      },
      "token_instances": [
        {
          "animation_url": "https://example.com",
          "external_app_url": "https://example.com",
          "image_url": "https://example.com",
          "media_type": "image/png",
          "media_url": "https://example.com",
          "metadata": {
            "description": "Test",
            "image": "https://example.com/image.png",
            "name": "Test"
          },
          "token": {
            "icon_url": "https://example.com"
          }
        }
      ]
    }
  ],
  "next_page_params": {
    "token_contract_address_hash": "0x1ffe11b9fb7f6ff1b153ab8608cf403ecaf9d44a",
    "token_type": "ERC-721"
  }
}