Overview
The Multi-Chain Stablecoin Balance API marketplace 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.
Unlike most marketplace 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.
We ❤️ Feedback!
If you have any feedback or questions about this documentation, let us know. We'd love to hear from you!