Skip to main content
GET
/
addresses
/
{address_hash}
/
nft
/
collections
List NFTs owned by an address grouped by collection/project
curl --request GET \
  --url 'https://api.blockscout.com/{chain_id}/api/v2/addresses/{address_hash}/nft/collections?apikey='
{
  "items": [
    {
      "token": {
        "address": "0x1234567890123456789012345678901234567890",
        "type": "ERC-20",
        "name": "<string>",
        "symbol": "<string>",
        "decimals": "<string>",
        "total_supply": "1000000000000000000",
        "exchange_rate": "<string>",
        "holders": "<string>",
        "icon_url": "<string>"
      },
      "amount": "1000000000000000000",
      "token_instances": [
        {
          "id": "1000000000000000000",
          "metadata": {},
          "image_url": "<string>",
          "animation_url": "<string>",
          "external_app_url": "<string>"
        }
      ]
    }
  ],
  "next_page_params": {}
}

Authorizations

​
apikey
string
query
required

API key passed as query parameter (format proapi_xxxxxxxx)

Path Parameters

​
address_hash
string
required

Address hash to query Address hash with 0x prefix

Example:

"0x1234567890123456789012345678901234567890"

Query Parameters

​
apikey
string

API key for rate limiting or for sensitive endpoints

Example:

"proapi_xxxxxxxx"

​
key
string

Secret key for getting access to restricted resources

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

Example:

"ERC-721,ERC-1155"

​
items_count
integer
default:50

Number of items returned per page

Required range: 1 <= x <= 50
​
token_contract_address_hash
string

Token contract address hash for pagination cursor Address hash with 0x prefix

Example:

"0x1234567890123456789012345678901234567890"

​
token_type
enum<string>

Token type for pagination cursor Token standard type:

  • ERC-20 - Fungible tokens
  • ERC-721 - Non-fungible tokens (NFTs)
  • ERC-1155 - Multi-token standard
  • ERC-404 - Hybrid fungible/non-fungible tokens
Available options:
ERC-20,
ERC-721,
ERC-1155,
ERC-404

Response

NFTs owned by the specified address, grouped by collection

Pagination metadata

​
items
object[]
required
​
next_page_params
object

Parameters for fetching the next page