Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
addresses

List token balances for an address with pagination and type filtering

Retrieves token balances for a specific address with pagination and filtering by token type. Useful for displaying large token portfolios.

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

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-20 - Fungible tokens
  • ERC-721 - Non-fungible tokens
  • ERC-1155 - Multi-token standard
  • ERC-404 - Hybrid fungible/non-fungible tokens

Example: ERC-20,ERC-721 to show both fungible and NFT transfers

items_countinteger

Number of items per page

string
OR
string
OR
string

Fiat value for paging

idinteger

ID for paging

string
OR
string
OR
string

Transaction value for paging

Response

Token balances for the specified address with pagination.

next_page_paramsobject nullable required

Example response

{
  "items": [
    {
      "token_instance": {
        "id": "431",
        "holder_address_hash": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
        "image_url": "example.com/picture.png",
        "animation_url": "example.com/video.mp4",
        "external_app_url": "d-app.com",
        "metadata": {
          "year": 2023,
          "tags": [
            "poap",
            "event"
          ],
          "name": "Social Listening Committee #2 Attendees",
          "image_url": "https://assets.poap.xyz/chanel-poap-4c-2023-logo-1675083420470.png",
          "home_url": "https://app.poap.xyz/token/6292128",
          "external_url": "https://api.poap.tech/metadata/99010/6292128",
          "description": "This is the POAP for attendees of the second Social Listening Committee.",
          "attributes": [
            {
              "value": "01-Feb-2023",
              "trait_type": "startDate"
            },
            {
              "value": "01-Feb-2023",
              "trait_type": "endDate"
            },
            {
              "value": "false",
              "trait_type": "virtualEvent"
            },
            {
              "value": "Paris",
              "trait_type": "city"
            },
            {
              "value": "France",
              "trait_type": "country"
            },
            {
              "value": "https://www.chanel.com",
              "trait_type": "eventURL"
            }
          ]
        },
        "owner": {
          "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
          "implementation_name": "implementationName",
          "name": "contractName",
          "ens_domain_name": "domain.eth",
          "metadata": {
            "slug": "tag_slug",
            "name": "Tag name",
            "tagType": "name",
            "ordinal": 0,
            "meta": {}
          },
          "private_tags": [
            {
              "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
              "display_name": "name to show",
              "label": "label"
            }
          ],
          "public_tags": [
            {
              "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
              "display_name": "name to show",
              "label": "label"
            }
          ]
        },
        "token": {
          "circulating_market_cap": "83606435600.3635",
          "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
          "name": "Tether USD",
          "decimals": "6",
          "symbol": "USDT",
          "address_hash": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
          "type": "ERC-20",
          "holders_count": "837494234523",
          "exchange_rate": "0.99",
          "total_supply": "10000000"
        }
      },
      "value": "10000",
      "token_id": "123",
      "token": {
        "icon_url": "https://example.com"
      }
    }
  ],
  "next_page_params": {
    "fiat_value": null,
    "id": 12519063346,
    "value": "3750000000000000000000"
  }
}