getStablecoinBalances RPC Method - Multi-Chain Stablecoin Balance API

Please note that this RPC method requires the Multi-Chain Stablecoin Balance API add-on enabled on your Quicknode endpoint. This method is only supported on Mainnet networks of all supported chains.

Parameters

address

string

REQUIRED

Loading...

chains

array

Loading...

tokens

array

Loading...

contract_addresses

array

Loading...

peg_types

array

Loading...

backing_types

array

Loading...

issuer_types

array

Loading...

vm_types

array

Loading...

Returns

result

object

Loading...

address

string

Loading...

chains

object

Loading...

chain_name

object

Loading...

chain_id

number

Loading...

balances

array

Loading...

token

string

Loading...

contract_address

string

Loading...

decimals

number

Loading...

balance_raw

string

Loading...

balance_formatted

string

Loading...

timestamp

string

Loading...

total_balances

array

Loading...

token

string

Loading...

decimals

number

Loading...

balance_raw

string

Loading...

balance_formatted

string

Loading...

Request

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "jsonrpc": "2.0",
6
    "method": "getStablecoinBalances",
7
    "params": {
8
        "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
9
        "chains": [
10
            "ethereum",
11
            "polygon"
12
        ],
13
        "tokens": [
14
            "USDT",
15
            "USDC"
16
        ]
17
    },
18
    "id": 1
19
}'
20

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "jsonrpc": "2.0",
6
    "method": "getStablecoinBalances",
7
    "params": {
8
        "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
9
        "chains": [
10
            "ethereum",
11
            "polygon"
12
        ],
13
        "tokens": [
14
            "USDT",
15
            "USDC"
16
        ]
17
    },
18
    "id": 1
19
}'
20

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

4
var raw = JSON.stringify({
5
  "method": "getStablecoinBalances",
6
  "params": {
7
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
8
    "chains": [
9
      "ethereum",
10
      "polygon"
11
    ],
12
    "tokens": [
13
      "USDT",
14
      "USDC"
15
    ]
16
  },
17
  "id": 1,
18
  "jsonrpc": "2.0"
19
});
20

21
var requestOptions = {
22
  method: 'POST',
23
  headers: myHeaders,
24
  body: raw,
25
  redirect: 'follow'
26
};
27

28
fetch("https://docs-demo.quiknode.pro/", requestOptions)
29
  .then(response => response.text())
30
  .then(result => console.log(result))
31
  .catch(error => console.log('error', error));
32

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

4
var raw = JSON.stringify({
5
  "method": "getStablecoinBalances",
6
  "params": {
7
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
8
    "chains": [
9
      "ethereum",
10
      "polygon"
11
    ],
12
    "tokens": [
13
      "USDT",
14
      "USDC"
15
    ]
16
  },
17
  "id": 1,
18
  "jsonrpc": "2.0"
19
});
20

21
var requestOptions = {
22
  method: 'POST',
23
  headers: myHeaders,
24
  body: raw,
25
  redirect: 'follow'
26
};
27

28
fetch("https://docs-demo.quiknode.pro/", requestOptions)
29
  .then(response => response.text())
30
  .then(result => console.log(result))
31
  .catch(error => console.log('error', error));
32

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "getStablecoinBalances",
8
  "params": {
9
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
10
    "chains": [
11
      "ethereum",
12
      "polygon"
13
    ],
14
    "tokens": [
15
      "USDT",
16
      "USDC"
17
    ]
18
  },
19
  "id": 1,
20
  "jsonrpc": "2.0"
21
})
22
headers = {
23
  'Content-Type': 'application/json'
24
}
25

26
response = requests.request("POST", url, headers=headers, data=payload)
27

28
print(response.text)
29

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "getStablecoinBalances",
8
  "params": {
9
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
10
    "chains": [
11
      "ethereum",
12
      "polygon"
13
    ],
14
    "tokens": [
15
      "USDT",
16
      "USDC"
17
    ]
18
  },
19
  "id": 1,
20
  "jsonrpc": "2.0"
21
})
22
headers = {
23
  'Content-Type': 'application/json'
24
}
25

26
response = requests.request("POST", url, headers=headers, data=payload)
27

28
print(response.text)
29

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

5
url = URI("https://docs-demo.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": "getStablecoinBalances",
14
  "params": {
15
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
16
    "chains": [
17
      "ethereum",
18
      "polygon"
19
    ],
20
    "tokens": [
21
      "USDT",
22
      "USDC"
23
    ]
24
  },
25
  "id": 1,
26
  "jsonrpc": "2.0"
27
})
28

29
response = https.request(request)
30
puts response.read_body
31

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

5
url = URI("https://docs-demo.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": "getStablecoinBalances",
14
  "params": {
15
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
16
    "chains": [
17
      "ethereum",
18
      "polygon"
19
    ],
20
    "tokens": [
21
      "USDT",
22
      "USDC"
23
    ]
24
  },
25
  "id": 1,
26
  "jsonrpc": "2.0"
27
})
28

29
response = https.request(request)
30
puts response.read_body
31

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
5
    "chains": {
6
      "ethereum": {
7
        "balances": [
8
          {
9
            "balance_formatted": "22794505870.275000",
10
            "balance_raw": "22794505870275000",
11
            "contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
12
            "decimals": 6,
13
            "token": "USDT"
14
          }
15
        ],
16
        "chain_id": 1
17
      },
18
      "polygon": {
19
        "balances": [
20
          {
21
            "balance_formatted": "64.555497",
22
            "balance_raw": "64555497",
23
            "contract_address": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
24
            "decimals": 6,
25
            "token": "USDC"
26
          }
27
        ],
28
        "chain_id": 137
29
      }
30
    },
31
    "timestamp": "2025-10-16T10:56:11.915517401+00:00",
32
    "total_balances": [
33
      {
34
        "balance_formatted": "64.555497",
35
        "balance_raw": "64555497",
36
        "decimals": 6,
37
        "token": "USDC"
38
      },
39
      {
40
        "balance_formatted": "22794505870.275",
41
        "balance_raw": "22794505870275000",
42
        "decimals": 6,
43
        "token": "USDT"
44
      }
45
    ]
46
  },
47
  "id": 1
48
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
5
    "chains": {
6
      "ethereum": {
7
        "balances": [
8
          {
9
            "balance_formatted": "22794505870.275000",
10
            "balance_raw": "22794505870275000",
11
            "contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
12
            "decimals": 6,
13
            "token": "USDT"
14
          }
15
        ],
16
        "chain_id": 1
17
      },
18
      "polygon": {
19
        "balances": [
20
          {
21
            "balance_formatted": "64.555497",
22
            "balance_raw": "64555497",
23
            "contract_address": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
24
            "decimals": 6,
25
            "token": "USDC"
26
          }
27
        ],
28
        "chain_id": 137
29
      }
30
    },
31
    "timestamp": "2025-10-16T10:56:11.915517401+00:00",
32
    "total_balances": [
33
      {
34
        "balance_formatted": "64.555497",
35
        "balance_raw": "64555497",
36
        "decimals": 6,
37
        "token": "USDC"
38
      },
39
      {
40
        "balance_formatted": "22794505870.275",
41
        "balance_raw": "22794505870275000",
42
        "decimals": 6,
43
        "token": "USDT"
44
      }
45
    ]
46
  },
47
  "id": 1
48
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free