Get Token Info

Method Signature

align.blockchain.tokens.getTokenInfo(
  tokenAddress: string,
  provider: JsonRpcProvider,
  network: Network,
  token?: Token
): Promise<TokenInfo>

Parameters

string

required

Token contract address

JsonRpcProvider

required

Connected ethers.js provider

string

required

Network identifier

string

Optional known token identifier for caching

Returns

string

Token name (e.g., “USD Coin”)

string

Token symbol (e.g., “USDC”)

number

Token decimals (e.g., 6)

string

Contract address

Examples

TypeScript
JavaScript

import Align from "@tolbel/align";

const align = new Align({
  apiKey: process.env.ALIGN_API_KEY!,
  environment: "sandbox",
});

const provider = align.blockchain.providers.getProvider("polygon");

const info = await align.blockchain.tokens.getTokenInfo(
  "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
  provider,
  "polygon"
);

console.log(`Name: ${info.name}`);       // USD Coin
console.log(`Symbol: ${info.symbol}`);   // USDC
console.log(`Decimals: ${info.decimals}`); // 6

const provider = align.blockchain.providers.getProvider("polygon");
const info = await align.blockchain.tokens.getTokenInfo(
  tokenAddress, provider, "polygon"
);
console.log(info.symbol, info.decimals);

Display Token with Correct Formatting

const info = await align.blockchain.tokens.getTokenInfo(
  tokenAddress,
  provider,
  "polygon"
);

// Get raw balance
const rawBalance = await getContractBalance(address, tokenAddress);

// Format with correct decimals
const formatted = align.blockchain.tokens.formatAmount(
  rawBalance,
  info.decimals
);

console.log(`${formatted} ${info.symbol}`);
// 1,234.56 USDC

Get Token Address

Get known token address

Format Amount

Format raw amounts

Getting Started

API Reference

Method Signature

Parameters

Returns

Examples

Display Token with Correct Formatting

Get Token Address

Format Amount

​Method Signature

​Parameters

​Returns

​Examples

​Display Token with Correct Formatting

​Related Methods

Get Token Address

Format Amount

Method Signature

Parameters

Returns

Examples

Display Token with Correct Formatting

Related Methods