diff --git a/resources/supported-chains-and-currencies.mdx b/resources/supported-chains-and-currencies.mdx index 65d9697..fd82825 100644 --- a/resources/supported-chains-and-currencies.mdx +++ b/resources/supported-chains-and-currencies.mdx @@ -5,7 +5,7 @@ description: "Supported chains and currency coverage across Request Network API ## Request Network API Supported Chains and Currencies -Overall, Request Network API supports 500+ currencies across major EVM chains. +Overall, Request Network API supports 500+ currencies across EVM-compatible chains and select non-EVM support (Tron). ## ERC20, Native, and Conversion Payments Supported Chains @@ -22,6 +22,8 @@ EVM chains supported for core payment flows include: - zkSync Era - Sepolia +For non-EVM support, Request Network API also supports Tron for USDT TRC-20 payments. + ## ERC20 and Native Payments Supported Currencies For ERC20 and native payments, Request Network API supports 500+ tokens. @@ -51,6 +53,20 @@ For Conversion Payments, supported **payment currencies** include: - DAI - FAU (Sepolia) +## Tron Supported Network and Currency + + +- **Availability:** Mainnet only +- **Native Token:** TRX +- **Supported Token:** USDT (TRC-20) +- **Network ID:** `tron` +- **Best For:** High-volume USDT transfers with low fees + + + +Tron uses TRC-20 (not ERC-20). Wallet addresses use the `T...` format. + + To fetch supported payment currencies for an invoice currency: @@ -93,6 +109,47 @@ Typical fields include: - `type` - `chainId` +## Currency Codes and Examples + + +```javascript Native and ERC20 examples +"ETH-mainnet" +"USDC-mainnet" +"USDC-base" +"USDT-arbitrum-one" +"DAI-optimism" +``` + +```javascript Tron example +"USDT-tron" +``` + +```javascript Fiat invoice currency examples +"USD" +"EUR" +"GBP" +``` + + +## API Query Examples + + +```bash Get all currencies +curl -X GET 'https://api.request.network/v2/currencies' \ + -H 'x-api-key: YOUR_API_KEY' +``` + +```bash Filter by network and symbol +curl -X GET 'https://api.request.network/v2/currencies?network=base&symbol=USDC&firstOnly=true' \ + -H 'x-api-key: YOUR_API_KEY' +``` + +```bash Get conversion routes for invoice currency +curl -X GET 'https://api.request.network/v2/currencies/USD/conversion-routes' \ + -H 'x-api-key: YOUR_API_KEY' +``` + + ## Endpoints diff --git a/resources/token-list.mdx b/resources/token-list.mdx index 6f9e311..34e82ed 100644 --- a/resources/token-list.mdx +++ b/resources/token-list.mdx @@ -1,24 +1,38 @@ ---- -title: "Request Network Token List" -description: "The [Request Network Token List](https://requestnetwork.github.io/request-token-list/latest.json) is a curated list of tokens supported by Request Network products. The token list follows a standardized format and includes essential information about each token, such as address, symbol, name, decimals, and chainId." - ---- - - -**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). - - -## Usage - -The token list is available at: [https://requestnetwork.github.io/request-token-list/latest.json](https://requestnetwork.github.io/request-token-list/latest.json) +--- +title: "Request Network Token List" +description: "The [Request Network Token List](https://requestnetwork.github.io/request-token-list/latest.json) is a curated list of tokens supported by Request Network products. The token list follows a standardized format and includes essential information about each token, such as address, symbol, name, decimals, and chainId." + +--- + +## Usage + + +Access the latest published token list JSON. + You can fetch the token list directly in your application: ```typescript -const tokenList = await fetch( - "https://requestnetwork.github.io/request-token-list/latest.json" -).then((res) => res.json()); -``` +const tokenList = await fetch( + "https://requestnetwork.github.io/request-token-list/latest.json" +).then((res) => res.json()); +``` + +## Token List vs Currencies API + +Use the token list for static token metadata and broad catalog browsing. + +Use the Currencies API when you need runtime filtering by network/symbol/id or conversion-route discovery. + + + + Query currencies with optional filters (`network`, `symbol`, `id`). + + + + Fetch payment currencies available for a specific invoice currency. + + ## Token List Structure @@ -50,9 +64,7 @@ Each token in the list contains the following information: | `hash` | For ERC20 tokens, same as `address`. For native tokens, a calculated hash. | | `chainId` | Chain ID of the network | -See the [SDK source code](https://github.com/RequestNetwork/requestNetwork/blob/master/packages/types/src/currency-types.ts) for the full list of supported networks and types. - -## Adding a New Token +## Adding a New Token We welcome community contributions! To add a new token to the list: