▾ How to check TIP-20 token balances

Since Tempo does not have a native token, you need to query TIP-20 stablecoin contracts directly to check account balances. Use the balanceOf function on the token contract.

Example using ethers.js:

const ethers = require('ethers');
const NODE_URL = "YOUR_QUICKNODE_ENDPOINT";
const provider = new ethers.JsonRpcProvider(NODE_URL);

// pathUSD token contract address
const PATHUSD_ADDRESS = "0x20c0000000000000000000000000000000000000";

async function checkTokenBalance(address) {
    const abi = ["function balanceOf(address) view returns (uint256)"];
    const tokenContract = new ethers.Contract(PATHUSD_ADDRESS, abi, provider);
    const balance = await tokenContract.balanceOf(address);

    // TIP-20 tokens use 6 decimal places
    const formattedBalance = ethers.formatUnits(balance, 6);
    console.log(`pathUSD balance: ${formattedBalance}`);
}

checkTokenBalance("0x9729187D9E8Bbefa8295F39f5634cA454dd9d294");

Available TIP-20 stablecoins:

Token	Address
pathUSD	0x20c0000000000000000000000000000000000000
AlphaUSD	0x20c0000000000000000000000000000000000001
BetaUSD	0x20c0000000000000000000000000000000000002
ThetaUSD	0x20c0000000000000000000000000000000000003

Parameters

address

string

REQUIRED

The address (20 bytes) to check for balance

blockNumber

string

REQUIRED

The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized (safe and finalized tags are only supported on Ethereum, Gnosis, Arbitrum, Arbitrum Nova and Avalanche C-chain), see the default block parameter description in the official Ethereum documentation

Returns

result

string

A placeholder balance value in hexadecimal format

Request

1
curl -X POST "https://docs-demo.tempo-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
8
    "latest"
9
  ],
10
  "id": 1
11
}'

1
curl -X POST "https://docs-demo.tempo-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
8
    "latest"
9
  ],
10
  "id": 1
11
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBalance", [
6
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
7
    "latest"
8
]);
9
    console.log(response);
10
}
11

12
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBalance", [
6
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
7
    "latest"
8
]);
9
    console.log(response);
10
}
11

12
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBalance", ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C","latest"])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBalance", ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C","latest"])
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.tempo-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_getBalance',
10
        params: [
11
          "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
12
          "latest"
13
        ]
14
    })
15

16
    console.log(result)
17
}
18

19
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.tempo-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_getBalance',
10
        params: [
11
          "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
12
          "latest"
13
        ]
14
    })
15

16
    console.log(result)
17
}
18

19
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getBalance',
7
  [
8
  "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
9
  "latest"
10
],
11
  undefined,
12
  'https://docs-demo.tempo-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getBalance',
7
  [
8
  "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
9
  "latest"
10
],
11
  undefined,
12
  'https://docs-demo.tempo-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_getBalance",
8
        [
9
            "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
10
            "latest"
11
        ],
12
        endpoint_url="https://docs-demo.tempo-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_getBalance",
8
        [
9
            "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
10
            "latest"
11
        ],
12
        endpoint_url="https://docs-demo.tempo-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_getBalance",
7
  params: [
8
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
9
    "latest"
10
  ],
11
  endpoint_url: "https://docs-demo.tempo-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_getBalance",
7
  params: [
8
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
9
    "latest"
10
  ],
11
  endpoint_url: "https://docs-demo.tempo-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_getBalance",
10
            Some(serde_json::json!([
11
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
12
    "latest"
13
])),
14
            None,
15
            Some("https://docs-demo.tempo-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

19
    println!("{result}");
20
    Ok(())
21
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_getBalance",
10
            Some(serde_json::json!([
11
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
12
    "latest"
13
])),
14
            None,
15
            Some("https://docs-demo.tempo-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

19
    println!("{result}");
20
    Ok(())
21
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getBalance',
4
    params: ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C","latest"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.tempo-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getBalance',
4
    params: ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C","latest"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.tempo-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.tempo-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBalance",
9
  "params": [
10
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
11
    "latest"
12
  ],
13
  "id": 1
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.tempo-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBalance",
9
  "params": [
10
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
11
    "latest"
12
  ],
13
  "id": 1
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.tempo-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBalance",
11
  params: ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C","latest"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.tempo-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBalance",
11
  params: ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C","latest"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": "0x9612084f0316e0ebd5182f398e5195a51b5ca47667d4c9b26c9b26c9b26c9b2"
5
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": "0x9612084f0316e0ebd5182f398e5195a51b5ca47667d4c9b26c9b26c9b26c9b2"
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free