eth_getBalance RPC Method

▾ 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

Loading...

blockNumber

string

REQUIRED

Loading...

Returns

result

string

Loading...

Request

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

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

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.tempo-mainnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getBalance",
7
    "params": ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C", 'latest'],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.tempo-mainnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getBalance",
7
    "params": ["0x475818D36D75207b5fF874C8EdC5A474d44fE52C", 'latest'],
8
    "id": "1"
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
4
  const balance = await provider.getBalance(
5
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
6
    "latest"
7
  );
8
  console.log(balance);
9
})();
10

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
4
  const balance = await provider.getBalance(
5
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
6
    "latest"
7
  );
8
  console.log(balance);
9
})();
10

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
8
    "latest"
9
  ],
10
  "id": 1,
11
  "jsonrpc": "2.0"
12
});
13

14
var requestOptions = {
15
  method: 'POST',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://docs-demo.tempo-mainnet.quiknode.pro/", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_getBalance",
6
  "params": [
7
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
8
    "latest"
9
  ],
10
  "id": 1,
11
  "jsonrpc": "2.0"
12
});
13

14
var requestOptions = {
15
  method: 'POST',
16
  headers: myHeaders,
17
  body: raw,
18
  redirect: 'follow'
19
};
20

21
fetch("https://docs-demo.tempo-mainnet.quiknode.pro/", requestOptions)
22
  .then(response => response.text())
23
  .then(result => console.log(result))
24
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "eth_getBalance",
8
  "params": [
9
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
10
    "latest"
11
  ],
12
  "id": 1,
13
  "jsonrpc": "2.0"
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)
22

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "eth_getBalance",
8
  "params": [
9
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
10
    "latest"
11
  ],
12
  "id": 1,
13
  "jsonrpc": "2.0"
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)
22

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

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

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_getBalance",
14
  "params": [
15
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
16
    "latest"
17
  ],
18
  "id": 1,
19
  "jsonrpc": "2.0"
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

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

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

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_getBalance",
14
  "params": [
15
    "0x475818D36D75207b5fF874C8EdC5A474d44fE52C",
16
    "latest"
17
  ],
18
  "id": 1,
19
  "jsonrpc": "2.0"
20
})
21

22
response = https.request(request)
23
puts response.read_body
24

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
print (w3.eth.get_balance('0x475818D36D75207b5fF874C8EdC5A474d44fE52C', 'latest'))

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
print (w3.eth.get_balance('0x475818D36D75207b5fF874C8EdC5A474d44fE52C', 'latest'))

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

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.tempo-mainnet.quiknode.pro/",
5
})
6

7
core.client
8
  .getBalance({
9
    address: '0x475818D36D75207b5fF874C8EdC5A474d44fE52C',
10
  })
11
  .then(res => console.log(res))
12

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

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.tempo-mainnet.quiknode.pro/",
5
})
6

7
core.client
8
  .getBalance({
9
    address: '0x475818D36D75207b5fF874C8EdC5A474d44fE52C',
10
  })
11
  .then(res => console.log(res))
12

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free