Get Holder Balance

Retrieve detailed balance information for a specific token holder, including their balance and its current value in USD.

GETapi.metal.build/token/:address/holder/:holderAddress

Get holder balance

This endpoint returns the balance and value information for a specific token holder.

Response attributes

  • Name
    name
    Type
    string
    Description

    The name of the token.

  • Name
    symbol
    Type
    string
    Description

    The token's symbol.

  • Name
    id
    Type
    string
    Description

    The token's contract address.

  • Name
    address
    Type
    string
    Description

    The token's contract address (same as id).

  • Name
    balance
    Type
    string
    Description

    The holder's token balance in wei (raw format).

Request

GET
api.metal.build/token/:address/holder/:holderAddress
curl https://api.metal.build/token/0x1234567890abcdef1234567890abcdef12345678/holder/0xabcdef1234567890abcdef1234567890abcdef12 \
  -H 'x-api-key': 'YOUR-API-KEY'

Response

{
    "name": "TestToken",
    "symbol": "TT",
    "id": "0xde522f429bde9776417985c6ebcdc9de872fd5c4",
    "address": "0xde522f429bde9776417985c6ebcdc9de872fd5c4",
    "balance": "1000000000000000000000"
}

Was this page helpful?