Skip to main content
POST
eth_getBalance
curl --request POST \
  --url https://rpc.testnet.tempo.xyz/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x9729187D9E8Bbefa8295F39f5634cA454dd9d294",
    "latest"
  ],
  "id": 1
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": "<string>"
}
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

Body

application/json
​
jsonrpc
string
default:2.0
​
method
string
default:eth_getBalance
​
params
any[]

Address and block parameter

​
id
integer
default:1

Response

200 - application/json

Placeholder balance value (Tempo has no native token)

​
jsonrpc
string
​
id
integer
​
result
string

Returns placeholder value 0x5e5de0bada3a8d... since Tempo has no native token