Multi-Chain Stablecoin Balance API | Quicknode Docs

Multi-Chain Stablecoin Balance API

Overview

The Multi-Chain Stablecoin Balance API add-on provides developers with a comprehensive solution for querying stablecoin balances across multiple blockchain networks. The API features automatic wallet type detection, supporting EVM (Ethereum Virtual Machine), SVM (Solana Virtual Machine), and TVM (Tron Virtual Machine) addresses, making it easy to track stablecoin holdings across diverse blockchain ecosystems.

Multi-Chain Architecture

Unlike most add-ons, the Multi-Chain Stablecoin Balance API returns balances across all supported chains regardless of which chain endpoint you enable it on. Whether you enable this add-on on an Ethereum, Polygon, or Solana endpoint, you'll receive multi-chain balance data when calling getStablecoinBalances. This unique architecture allows you to query stablecoin holdings across multiple blockchain networks from a single API call.

Key Features

Multi-Chain Support: Query stablecoin balances across 9 different blockchain networks including Ethereum, Blast, Polygon, BNB Smart Chain, Arbitrum, Optimism, Avalanche, Base, Solana, and Tron.
Automatic Wallet Detection: Automatically detects and handles different wallet address formats (EVM, Solana, and Tron) without requiring manual specification.
Flexible Filtering: Filter stablecoins by token symbol, contract address, peg type (USD, EUR, JPY), backing type (fiat-backed, crypto-backed, algorithmic), issuer type (centralized, decentralized), and VM type.
Comprehensive Token Coverage: Access data for major stablecoins including USDT, USDC, DAI, and many others across supported networks.
Real-Time Balance Data: Get up-to-date stablecoin balance information with precise decimal handling and timestamp tracking.

How to Enable the Add-on

Step 1: Visit the Quicknode dashboard.
Step 2: Select an endpoint for any supported chain from the Endpoints section.
Step 3: Navigate to the Add-on section of that endpoint.
Step 4: Look for the Multi-Chain Stablecoin Balance API and click Explore.
Step 5: Once enabled, use the Stablecoin API endpoint to start calling different methods the add-on has available. Check the documentation for the full list of supported methods.

Supported Blockchain Networks

The Multi-Chain Stablecoin Balance API supports the following blockchain networks:

Blockchain Network	Chain Identifier
Ethereum Mainnet	ethereum
Blast Mainnet	blast
Polygon Mainnet	polygon
BNB Smart Chain Mainnet	bsc
Arbitrum Mainnet	arbitrum
Optimism Mainnet	optimism
Avalanche C-Chain Mainnet	avalanche
Base Mainnet	base
Solana Mainnet	solana
Tron Mainnet	tron

Supported Methods

The API provides two main methods for interacting with stablecoin data:

getStablecoinBalances - Retrieves stablecoin balances for a given wallet address with optional filtering by chains, tokens, and stablecoin characteristics.
getSupportedStablecoins - Returns metadata about all supported stablecoins and blockchain networks.

Filter Categories

The API supports filtering stablecoins by several characteristics to help you find exactly what you need. You can use these filters individually or combine them for more specific results.

Peg Types

Filter stablecoins by the currency they are pegged to:

Filter	Description	Examples
`usd`	Stablecoins pegged to the US Dollar	USDT, USDC, DAI
`eur`	Stablecoins pegged to the Euro	EURS, EURT
`jpy`	Stablecoins pegged to the Japanese Yen	JPYC

Backing Types

Filter by how the stablecoin maintains its stability:

Filter	Description	Examples
`fiat_backed`	Backed by traditional fiat currency reserves	USDT, USDC
`crypto_backed`	Backed by cryptocurrency collateral	DAI, LUSD
`algorithmic`	Uses algorithms to maintain peg without backing assets	FRAX, UST
`algorithmic_hybrid`	Combines algorithmic mechanisms with some backing	FRAX
`synthetic`	Represents synthetic assets on-chain	sUSD

Issuer Types

Filter by the type of entity that issues the stablecoin:

Filter	Description	Examples
`centralized`	Issued by centralized companies or organizations	USDT, USDC
`decentralized`	Issued by decentralized protocols and DAOs	DAI, LUSD

VM Types

Filter by the blockchain virtual machine type:

Filter	Description	Supported Chains
`evm`	Ethereum Virtual Machine compatible chains	Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base
`svm`	Solana Virtual Machine	Solana
`tvm`	Tron Virtual Machine	Tron

Now that you understand the available filtering options, you're ready to start querying stablecoin data. The API provides a simple and consistent interface for accessing stablecoin balances and metadata across multiple blockchain networks.