Skip to content

docs(supported-chains): add Tron network support and enhance currency documentation #73

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aimensahnoun wants to merge 1 commit into
base: 03-03-docs_resources_point_supported-chains_cards_to_specific_section_anchors_improve_navigation_in_resources_supported-chains-and-currencies.mdx_by_updating_card_destinations_from_generic_page-level_links_to_section-level_anchors_so_
Choose a base branch
from
Open

docs(supported-chains): add Tron network support and enhance currency documentation #73

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 58 additions & 1 deletion resources/supported-chains-and-currencies.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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.
Expand Down Expand Up @@ -51,6 +53,20 @@ For Conversion Payments, supported **payment currencies** include:
- DAI
- FAU (Sepolia)

## Tron Supported Network and Currency

<Card title="Tron" icon="bolt">
- **Availability:** Mainnet only
- **Native Token:** TRX
- **Supported Token:** USDT (TRC-20)
- **Network ID:** `tron`
- **Best For:** High-volume USDT transfers with low fees
</Card>

<Warning>
Tron uses TRC-20 (not ERC-20). Wallet addresses use the `T...` format.
</Warning>

To fetch supported payment currencies for an invoice currency:

<Card title="GET /v2/currencies/{currencyId}/conversion-routes" href="https://api.request.network/open-api/#tag/v2currencies/GET/v2/currencies/%7BcurrencyId%7D/conversion-routes" icon="arrows-rotate">
Expand Down Expand Up @@ -93,6 +109,47 @@ Typical fields include:
- `type`
- `chainId`

## Currency Codes and Examples

<CodeGroup>
```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"
```
</CodeGroup>

## API Query Examples

<CodeGroup>
```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'
Comment on lines +143 to +144
Copy link

@greptile-apps greptile-apps bot Mar 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The firstOnly=true query parameter in this example should be verified against the Request Network API specification before publishing. If this parameter is not officially documented in the OpenAPI spec, the example could mislead developers. Please confirm this parameter is supported by checking the API documentation at https://api.request.network/open-api/, or remove it from the example if it is not part of the official API.

```

```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'
```
</CodeGroup>

## Endpoints

<CardGroup cols={2}>
Expand Down
52 changes: 32 additions & 20 deletions resources/token-list.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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."

---

<Warning>
**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).
</Warning>

## 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

<Card title="Request Token List JSON" href="https://requestnetwork.github.io/request-token-list/latest.json" icon="list">
Access the latest published token list JSON.
</Card>

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.

<CardGroup cols={2}>
<Card title="GET /v2/currencies" href="https://api.request.network/open-api/#tag/v2currencies/GET/v2/currencies" icon="coins">
Query currencies with optional filters (`network`, `symbol`, `id`).
</Card>

<Card title="GET /v2/currencies/{currencyId}/conversion-routes" href="https://api.request.network/open-api/#tag/v2currencies/GET/v2/currencies/%7BcurrencyId%7D/conversion-routes" icon="arrows-rotate">
Fetch payment currencies available for a specific invoice currency.
</Card>
</CardGroup>

## Token List Structure

Expand Down Expand Up @@ -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:
<Steps>
Expand Down