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

The wallet address to query. Supports EVM (0x...), Solana (base58), and Tron (T...) address formats.

chains

array

An array of blockchain identifiers to filter results. Supported chains: blast, ethereum, polygon, bsc, arbitrum, optimism, avalanche, base, solana, tron (mainnet networks only). If not specified, queries all supported chains

tokens

array

Optional array of token symbols to filter results (e.g., ["USDT", "USDC", "DAI"]).

contract_addresses

array

Optional array of specific token contract addresses or mint addresses to filter results.

peg_types

array

An array of peg types to filter stablecoins by their pegged currency. Supported types: usd, eur, jpy. If not specified, includes all peg types

backing_types

array

An array of backing types to filter stablecoins by their collateralization method. Supported types: fiat_backed, crypto_backed, algorithmic, algorithmic_hybrid, synthetic. If not specified, includes all backing types

issuer_types

array

An array of issuer types to filter stablecoins by their governance model. Supported types: centralized, decentralized. If not specified, includes all issuer types

vm_types

array

An array of virtual machine types to filter results by blockchain VM architecture. Supported types: evm, svm, tvm. If not specified, includes all VM types

Returns

result

object

The stablecoin balance data for the requested address

address

string

The wallet address that was queried

chains

object

Balances organized by chain name

chain_name

object

Balance data for a specific blockchain such as arbitrum, avalanche, base, bsc, ethereum, optimism, polygon

chain_id

number

EVM chain ID for this network

balances

array

Array of stablecoin balance objects on this chain

token

string

Token symbol such as USDT, USDC, TUSD

contract_address

string

ERC-20 contract address for EVM chains

decimals

number

Token decimals on this chain

balance_raw

string

Raw balance in smallest unit as a string

balance_formatted

string

Human-readable balance formatted using decimals

timestamp

string

ISO 8601 timestamp when the balances were computed

total_balances

array

Aggregated totals across all chains grouped by token symbol

token

string

Token symbol

decimals

number

Maximum decimals encountered for this token across chains

balance_raw

string

Total raw balance across all chains as a string

balance_formatted

string

Total human-readable balance across all chains

Request

1
curl -X POST "https://docs-demo.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
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
}'

1
curl -X POST "https://docs-demo.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
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
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'getStablecoinBalances',
4
    params: {"address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","chains":["ethereum","polygon"],"tokens":["USDT","USDC"]},
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.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: 'getStablecoinBalances',
4
    params: {"address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","chains":["ethereum","polygon"],"tokens":["USDT","USDC"]},
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.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.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "getStablecoinBalances",
9
  "params": {
10
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
11
    "chains": [
12
      "ethereum",
13
      "polygon"
14
    ],
15
    "tokens": [
16
      "USDT",
17
      "USDC"
18
    ]
19
  },
20
  "id": 1
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)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "getStablecoinBalances",
9
  "params": {
10
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
11
    "chains": [
12
      "ethereum",
13
      "polygon"
14
    ],
15
    "tokens": [
16
      "USDT",
17
      "USDC"
18
    ]
19
  },
20
  "id": 1
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)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getStablecoinBalances",
11
  params: {"address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","chains":["ethereum","polygon"],"tokens":["USDT","USDC"]}
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.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getStablecoinBalances",
11
  params: {"address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","chains":["ethereum","polygon"],"tokens":["USDT","USDC"]}
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
  "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