Get Single Token Balance

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

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

Get Single Token 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
number
Description
The holder's token balance.
Name
value
Type
number
Description
The holder's token balance in USD.
Will return null if no liquidity has been created for the token.

Request

GET

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

const response = await fetch(
  'https://api.metal.build/holder/0x1234567890abcdef1234567890abcdef12345678/token/0xabcdef1234567890abcdef1234567890abcdef12',
  {
    headers: {
      'x-api-key': 'YOUR-API-KEY',
    },
  }
)

const holder = await response.json()

Response

{
  name: "TestToken",
  symbol: "TT",
  id: "0xde522f429bde9776417985c6ebcdc9de872fd5c4",
  address: "0xde522f429bde9776417985c6ebcdc9de872fd5c4",
  balance: 2000000,
  value: 15.00
}