diff --git a/resources/supported-chains-and-currencies.mdx b/resources/supported-chains-and-currencies.mdx index 72ebb6e..65d9697 100644 --- a/resources/supported-chains-and-currencies.mdx +++ b/resources/supported-chains-and-currencies.mdx @@ -1,425 +1,122 @@ --- title: "Supported Chains and Currencies" -description: "Complete list of supported blockchain networks and currencies for Request Network" +description: "Supported chains and currency coverage across Request Network API payment types" --- - -**AI-Generated Content** – This page was generated with AI assistance and may contain inaccuracies. While likely close to accurate, please verify critical details with the [stable documentation](https://docs.request.network) or [contact support](https://github.com/orgs/RequestNetwork/discussions). - +## Request Network API Supported Chains and Currencies -## Overview +Overall, Request Network API supports 500+ currencies across major EVM chains. -Request Network supports payments across **EVM-compatible blockchain networks and select non-EVM chains** with **553+ currencies** including major cryptocurrencies, stablecoins, and fiat currencies. This comprehensive coverage ensures global accessibility and flexibility for all payment scenarios. +## ERC20, Native, and Conversion Payments Supported Chains -## Supported Blockchain Networks +EVM chains supported for core payment flows include: - - - **Mainnet & Sepolia Testnet** - - **Native Token:** ETH - **Popular Tokens:** USDC, USDT, DAI, LINK, UNI - **Network ID:** 1 (mainnet), 11155111 (sepolia) - - **Best For:** High-value transactions, DeFi integration - - - - **Mainnet & Mumbai Testnet** - - **Native Token:** MATIC - **Popular Tokens:** USDC, USDT, DAI, WETH - **Network ID:** 137 (mainnet), 80001 (mumbai) - - **Best For:** Low-cost transactions, high throughput - - +- Ethereum +- Arbitrum One +- OP Mainnet +- Base +- Polygon +- BSC +- Avalanche +- Fantom +- zkSync Era +- Sepolia - - - **One & Sepolia Testnet** - - **Native Token:** ETH - **Popular Tokens:** USDC, USDT, ARB, GMX - **Network ID:** 42161 (one), 421614 (sepolia) - - **Best For:** Lower fees with Ethereum security - - - - **Mainnet & Sepolia Testnet** - - **Native Token:** ETH - **Popular Tokens:** USDC, USDT, OP, SNX - **Network ID:** 10 (mainnet), 11155420 (sepolia) - - **Best For:** Fast transactions, Ethereum compatibility - - +## ERC20 and Native Payments Supported Currencies - - - **Mainnet & Sepolia Testnet** - - **Native Token:** ETH - **Popular Tokens:** USDC, cbETH, DAI - **Network ID:** 8453 (mainnet), 84532 (sepolia) - - **Best For:** Coinbase ecosystem integration - - - - **More Networks Available:** - - BSC (Binance Smart Chain) - - Avalanche C-Chain - - Fantom Opera - - Gnosis Chain - - Celo - - +For ERC20 and native payments, Request Network API supports 500+ tokens. - - - **Mainnet only** + +Access the full token catalog with token IDs, symbols, and network mapping. + - **Native Token:** TRX - **Supported Token:** USDT (TRC-20) - **Network ID:** `tron` + +The token list is a superset and may include tokens on chains outside your current payment flow. Cross-reference token entries with supported chains. + - **Best For:** High-volume USDT transfers with low fees +## Conversion Payments Supported Currencies - - Tron uses the **TRC-20** token standard, not ERC-20. Wallet addresses use the `T...` prefix format (e.g. `TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE`). Validate addresses against this format before creating requests. - - - +For Conversion Payments, supported **invoice currencies** include: -## Currency Categories - -### Major Cryptocurrencies - - - - **Blockchain Native Currencies:** - - | Currency | Symbol | Chains Available | - |----------|--------|------------------| - | Ethereum | ETH | Ethereum, Arbitrum, Optimism, Base | - | Polygon | MATIC | Polygon | - | Binance Coin | BNB | BSC | - | Avalanche | AVAX | Avalanche | - | Fantom | FTM | Fantom | - | Tron | TRX | Tron | - - - - **USD-Pegged Stablecoins:** - - | Currency | Symbol | Chains Available | - |----------|--------|------------------| - | USD Coin | USDC | All supported chains | - | Tether | USDT | Ethereum, Polygon, BSC, Avalanche, Tron | - | DAI | DAI | Ethereum, Polygon, Arbitrum, Optimism | - | BUSD | BUSD | BSC, Ethereum | - | FRAX | FRAX | Ethereum, Polygon, Arbitrum | - - **Other Stablecoins:** - - USDC.e (bridged USDC on various chains) - - sUSD (Synthetix USD) - - LUSD (Liquity USD) - - And many more... - - - - **DeFi & Ecosystem Tokens:** - - | Currency | Symbol | Primary Chains | - |----------|--------|----------------| - | Chainlink | LINK | Ethereum, Polygon, Arbitrum | - | Uniswap | UNI | Ethereum, Polygon, Arbitrum | - | Aave | AAVE | Ethereum, Polygon | - | Compound | COMP | Ethereum | - | Curve DAO | CRV | Ethereum, Polygon | - | 1inch | 1INCH | Ethereum, BSC | - - - -### Fiat Currencies - - - - **G7 & Major Global Currencies:** - - | Currency | Code | Region | - |----------|------|--------| - | US Dollar | USD | United States | - | Euro | EUR | European Union | - | British Pound | GBP | United Kingdom | - | Japanese Yen | JPY | Japan | - | Canadian Dollar | CAD | Canada | - | Australian Dollar | AUD | Australia | - | Swiss Franc | CHF | Switzerland | - | Chinese Yuan | CNY | China | - - **Note:** Fiat currencies are used for pricing and conversion. Actual payments settle in cryptocurrency. - - - - **Regional Currencies:** - - | Currency | Code | Region | - |----------|------|--------| - | Brazilian Real | BRL | Brazil | - | Indian Rupee | INR | India | - | Mexican Peso | MXN | Mexico | - | South African Rand | ZAR | South Africa | - | Turkish Lira | TRY | Turkey | - | Russian Ruble | RUB | Russia | - | Korean Won | KRW | South Korea | - | Thai Baht | THB | Thailand | - - **Total Coverage:** 150+ international fiat currencies - - - -## Currency Selection Guide - -### For Different Use Cases +- USD +- EUR +- CNY +- GBP +- JPY - - - **Recommended Currencies:** - - **Pricing:** USD, EUR, GBP (familiar fiat terms) - - **Settlement:** USDC, USDT, DAI (stable value) - - **Networks:** Polygon, Arbitrum (lower fees) - - [Learn More →](/use-cases/invoicing) - - - - **Recommended Currencies:** - - **High Volume:** USDC on Polygon (lowest fees) - - **Cross-border:** USDC, USDT (global acceptance) - - **Flexibility:** Native tokens for local markets - - [Learn More →](/use-cases/payouts) - - +For Conversion Payments, supported **payment currencies** include: + +- USDC +- USDT +- DAI +- FAU (Sepolia) + +To fetch supported payment currencies for an invoice currency: + + +Get payment currency options available for a given invoice currency. + + +## Crosschain Payments Supported Currencies + + +View the supported chain/currency matrix for crosschain payments. + + +## Crypto-to-fiat Payments Supported Currencies + + +View supported chains and currencies for crypto-to-fiat flows. + + +## Currencies API Endpoints + +The Currencies API lets you discover available currencies and conversion routes. + +### Key Features + +- **Payment request integration**: get currency IDs required for request creation +- **Payment integration**: retrieve token/network metadata for settlement logic +- **Currency validation**: verify supported currency IDs before creating requests +- **Multi-chain support**: discover tokens across supported chains + +### Currency Object Fields + +Typical fields include: + +- `id` (for example `USDC-mainnet`) +- `name` +- `symbol` +- `decimals` +- `address` +- `network` +- `type` +- `chainId` + +## Endpoints - - **Recommended Currencies:** - - **Customer Choice:** Multiple payment options - - **Conversion:** USD pricing, crypto settlement - - **Popular:** ETH, USDC, MATIC, BNB - - [Learn More →](/use-cases/checkout) + + List currencies and filter by network, symbol, or id. - - - **Recommended Currencies:** - - **Stability:** USDC, DAI (predictable values) - - **Low Fees:** Polygon, Arbitrum networks - - **Reliability:** Established stablecoins - - [Learn More →](/use-cases/subscriptions) + + + List payment currencies available for a given invoice currency. -## Network Selection Criteria - -### Cost Optimization - - - - **Average Transaction Costs (2025):** - - | Network | Native Transfer | ERC-20 Transfer | Typical Use | - |---------|----------------|-----------------|-------------| - | Polygon | $0.001-0.01 | $0.01-0.03 | High volume, frequent transactions | - | Arbitrum | $0.10-0.50 | $0.20-1.00 | Ethereum ecosystem, medium volume | - | Optimism | $0.10-0.50 | $0.20-1.00 | Ethereum ecosystem, medium volume | - | Base | $0.05-0.25 | $0.10-0.50 | Coinbase integration | - | Ethereum | $2-20 | $5-50 | High value, infrequent transactions | - - - **Fee Optimization Tips** - - - Use Polygon for high-frequency, low-value transactions - - Use Ethereum for high-value, security-critical transactions - - Consider L2 solutions (Arbitrum, Optimism) for balanced cost/security - - - - - **Transaction Confirmation Times:** - - | Network | Block Time | Practical Finality | Best For | - |---------|------------|-------------------|----------| - | Polygon | 2 seconds | 30-60 seconds | Real-time applications | - | Base | 2 seconds | 30-60 seconds | Fast user experiences | - | Arbitrum | 1 second | 5-15 minutes | Balanced speed/security | - | Optimism | 2 seconds | 5-15 minutes | Balanced speed/security | - | Ethereum | 12 seconds | 5-15 minutes | Maximum security | - - - - **Network Ecosystem Maturity:** - - | Network | TVL | DEX Liquidity | Ecosystem | Adoption | - |---------|-----|---------------|-----------|----------| - | Ethereum | Highest | Highest | Most mature | Universal | - | Polygon | High | High | Very mature | High | - | Arbitrum | High | High | Mature | High | - | Optimism | Medium | Medium | Growing | Medium | - | Base | Growing | Growing | New but strong | Growing | - - - -## Currency Codes and Formats - -### Standard Format - -Request Network uses standardized currency codes: - - -```javascript Native Tokens -// Format: {SYMBOL}-{NETWORK} -"ETH-mainnet" // Ethereum on Ethereum mainnet -"MATIC-matic" // MATIC on Polygon mainnet -"ETH-arbitrum-one" // ETH on Arbitrum One -"ETH-optimism" // ETH on Optimism -"BNB-bsc" // BNB on BSC -``` - -```javascript ERC-20 Tokens -// Format: {SYMBOL}-{NETWORK}-{OPTIONAL_SUFFIX} -"USDC-mainnet" // USDC on Ethereum -"USDC-matic" // USDC on Polygon -"USDC-arbitrum-one" // USDC on Arbitrum -"USDC-optimism" // USDC on Optimism -"USDT-mainnet" // USDT on Ethereum -"DAI-mainnet" // DAI on Ethereum -``` - -```javascript TRC-20 Tokens (Tron) -// Tron uses a separate token standard — not ERC-20 -"USDT-tron" // USDT on Tron mainnet -``` - -```javascript Fiat Currencies -// Format: {ISO_CODE} -"USD" // US Dollar -"EUR" // Euro -"GBP" // British Pound -"JPY" // Japanese Yen -"CAD" // Canadian Dollar -``` - - -### Currency Validation - - -```javascript Validate Currency -import { validateCurrency } from '@requestnetwork/request-client.js'; - -// Check if currency is supported -const isValid = validateCurrency('USDC-matic'); -console.log(isValid); // true - -// Get currency details -const currencyInfo = getCurrencyInfo('USDC-matic'); -console.log(currencyInfo); -// { -// symbol: 'USDC', -// network: 'matic', -// type: 'ERC20', -// decimals: 6, -// address: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174' -// } -``` - -```javascript API Currency Check -// Check supported currencies via API -const response = await fetch('https://api.request.network/v2/currencies', { - headers: { - 'Authorization': `Bearer ${apiKey}` - } -}); - -const currencies = await response.json(); -console.log(currencies.supported); -``` - - -## Real-Time Price Data - -Request Network uses multiple price feed sources for accurate conversions: - - - - **Primary Data Sources:** - - Chainlink Price Feeds (on-chain) - - CoinGecko API (market aggregation) - - CoinMarketCap API (market data) - - DEX aggregators (real-time trading data) - - **Update Frequency:** Sub-minute updates for major pairs - - - - **Fiat to Crypto:** - - Any fiat currency → Any supported cryptocurrency - - Real-time exchange rate calculation - - Slippage protection for large amounts - - **Crypto to Crypto:** - - Crosschain token conversions - - Optimal routing through DEX aggregators - - Minimal slippage and MEV protection - - - -## What's Next? +## Related Pages - - Complete token list with contract addresses and chain details - - - - Learn about different payment types and currency options - - - - Start building with your preferred currencies and networks + + Full token catalog with IDs and chain mapping. - - Learn about NEAR blockchain support and unique features + + Learn where each currency flow is used. - - USDT payments on Tron using the TRC-20 standard + + Build with supported currencies and chains.