Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
addresses

List NFTs owned by a specific address with optional type filtering

Retrieves a list of NFTs (non-fungible tokens) owned by a specific address, with optional filtering by token type.

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

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

Token ID 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, with pagination.

next_page_paramsobject nullable required

Example response

{
  "items": [
    {
      "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_id": "24950",
    "token_type": "ERC-721"
  }
}