Skip to main content
Tempo API method that returns the balance of an account.
Important: Tempo has no native token. This method returns a placeholder value instead of an actual balance. To check real balances, query TIP-20 stablecoin contracts using the balanceOf function.

Parameters

  • address — the address to check balance for
  • blockParameter — the block number (hex) or tag (latest, earliest, pending)

Response

  • result — returns a placeholder value 0x5e5de0bada3a8d... since Tempo has no native token

Checking TIP-20 token balances

To check actual stablecoin balances on Tempo, use eth_call with the TIP-20 balanceOf function:
const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

// pathUSD token address
const PATHUSD = "0x20c0000000000000000000000000000000000000";

const checkBalance = async (address) => {
    const abi = ["function balanceOf(address) view returns (uint256)"];
    const token = new ethers.Contract(PATHUSD, abi, provider);
    const balance = await token.balanceOf(address);
    // TIP-20 tokens use 6 decimals
    console.log(`pathUSD balance: ${ethers.formatUnits(balance, 6)}`);
  };

checkBalance("0x9729187D9E8Bbefa8295F39f5634cA454dd9d294");

Testnet tokens

Tempo testnet has these predeployed stablecoins:
TokenAddress
pathUSD0x20c0000000000000000000000000000000000000
AlphaUSD0x20c0000000000000000000000000000000000001
BetaUSD0x20c0000000000000000000000000000000000002
ThetaUSD0x20c0000000000000000000000000000000000003