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

chains

array

tokens

array

contract_addresses

array

peg_types

array

backing_types

array

issuer_types

array

vm_types

array

Returns

result

object

address

string

chains

object

chain_name

object

chain_id

number

balances

array

token

string

contract_address

string

decimals

number

balance_raw

string

balance_formatted

string

timestamp

string

total_balances

array

token

string

decimals

number

balance_raw

string

balance_formatted

string

Request

curl https://docs-demo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
    "jsonrpc": "2.0",
    "method": "getStablecoinBalances",
    "params": {
        "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
        "chains": [
            "ethereum",
            "polygon"
        ],
        "tokens": [
            "USDT",
            "USDC"
        ]
    },
    "id": 1
}'

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

var raw = JSON.stringify({
  "method": "getStablecoinBalances",
  "params": {
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
    "chains": [
      "ethereum",
      "polygon"
    ],
    "tokens": [
      "USDT",
      "USDC"
    ]
  },
  "id": 1,
  "jsonrpc": "2.0"
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

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

import requests
import json

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

payload = json.dumps({
  "method": "getStablecoinBalances",
  "params": {
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
    "chains": [
      "ethereum",
      "polygon"
    ],
    "tokens": [
      "USDT",
      "USDC"
    ]
  },
  "id": 1,
  "jsonrpc": "2.0"
})
headers = {
  'Content-Type': 'application/json'
}

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

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "getStablecoinBalances",
  "params": {
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
    "chains": [
      "ethereum",
      "polygon"
    ],
    "tokens": [
      "USDT",
      "USDC"
    ]
  },
  "id": 1,
  "jsonrpc": "2.0"
})

response = https.request(request)
puts response.read_body

Response

{
  "jsonrpc": "2.0",
  "result": {
    "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
    "chains": {
      "ethereum": {
        "balances": [
          {
            "balance_formatted": "22794505870.275000",
            "balance_raw": "22794505870275000",
            "contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
            "decimals": 6,
            "token": "USDT"
          }
        ],
        "chain_id": 1
      },
      "polygon": {
        "balances": [
          {
            "balance_formatted": "64.555497",
            "balance_raw": "64555497",
            "contract_address": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
            "decimals": 6,
            "token": "USDC"
          }
        ],
        "chain_id": 137
      }
    },
    "timestamp": "2025-10-16T10:56:11.915517401+00:00",
    "total_balances": [
      {
        "balance_formatted": "64.555497",
        "balance_raw": "64555497",
        "decimals": 6,
        "token": "USDC"
      },
      {
        "balance_formatted": "22794505870.275",
        "balance_raw": "22794505870275000",
        "decimals": 6,
        "token": "USDT"
      }
    ]
  },
  "id": 1
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

getStablecoinBalances RPC Method - Multi-Chain Stablecoin Balance API

Loading...

Parameters

Returns