From b5a3a67ff18a9c769f360a0447a4b2f11fe789e5 Mon Sep 17 00:00:00 2001 From: Aimen Sahnoun Date: Tue, 3 Mar 2026 15:53:57 +0400 Subject: [PATCH] =?UTF-8?q?docs(resources):=20refine=20chains/currencies?= =?UTF-8?q?=20and=20token=20list=20with=20Tron-safe=20updates=20Improve=20?= =?UTF-8?q?resource=20pages=20for=20supported=20chains/currencies=20and=20?= =?UTF-8?q?token=20discovery=20while=20preserving=20required=20Tron=20cove?= =?UTF-8?q?rage=20and=20improving=20navigation=20clarity.=20-=20update=20`?= =?UTF-8?q?supported-chains-and-currencies`=20with=20clearer=20coverage=20?= =?UTF-8?q?wording:=20=20=20EVM-compatible=20chains=20+=20select=20non-EVM?= =?UTF-8?q?=20support=20(Tron)=20-=20keep=20and=20structure=20Tron-specifi?= =?UTF-8?q?c=20support=20details=20where=20relevant=20=20=20(network,=20to?= =?UTF-8?q?ken=20standard,=20address-format=20warning,=20examples)=20-=20c?= =?UTF-8?q?onvert=20key=20references=20from=20generic=20links=20to=20cards?= =?UTF-8?q?=20for=20better=20UX=20-=20update=20card=20targets=20to=20secti?= =?UTF-8?q?on-level=20anchors=20where=20possible=20to=20reduce=20navigatio?= =?UTF-8?q?n=20friction=20-=20keep=20currencies=20endpoint=20references=20?= =?UTF-8?q?visible=20and=20actionable=20-=20update=20`token-list`=20by=20r?= =?UTF-8?q?emoving=20outdated=20AI=20warning=20and=20simplifying=20usage?= =?UTF-8?q?=20flow=20-=20replace=20raw=20usage=20URL=20text=20with=20a=20d?= =?UTF-8?q?edicated=20=E2=80=9CRequest=20Token=20List=20JSON=E2=80=9D=20ca?= =?UTF-8?q?rd=20-=20keep=20legacy=20token-list=20structure/content=20intac?= =?UTF-8?q?t=20-=20add=20concise=20=E2=80=9CToken=20List=20vs=20Currencies?= =?UTF-8?q?=20API=E2=80=9D=20guidance=20with=20endpoint=20cards=20-=20remo?= =?UTF-8?q?ve=20unnecessary=20SDK-source=20reference=20line=20to=20keep=20?= =?UTF-8?q?page=20focused?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- resources/supported-chains-and-currencies.mdx | 59 ++++++++++++++++++- resources/token-list.mdx | 52 +++++++++------- 2 files changed, 90 insertions(+), 21 deletions(-) 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: