> ## Documentation Index
> Fetch the complete documentation index at: https://docs.request.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Request Network Token List

> 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 theme={null}
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

Each token in the list contains the following information:

```json theme={null}
{
  "id": "USDC-mainnet",
  "name": "USD Coin",
  "symbol": "USDC",
  "decimals": 6,
  "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "network": "mainnet",
  "type": "ERC20",
  "hash": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "chainId": 1
}
```

Tron tokens use the same shape — `network: "tron"`, `chainId: 728126428`, `type: "TRC20"`, and base58 addresses (`T...`):

```json theme={null}
{
  "id": "USDT-tron",
  "name": "Tether USD",
  "symbol": "USDT",
  "decimals": 6,
  "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "network": "tron",
  "type": "TRC20",
  "chainId": 728126428
}
```

| Field      | Description                                                                                                                    |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `id`       | Unique identifier, typically `SYMBOL-network` (e.g., `USDC-mainnet`)                                                           |
| `name`     | Human-readable token name                                                                                                      |
| `symbol`   | Token symbol                                                                                                                   |
| `decimals` | Number of decimal places                                                                                                       |
| `address`  | Token contract address                                                                                                         |
| `network`  | Network name. Supported destination networks: `mainnet`, `arbitrum-one`, `optimism`, `base`, `matic`, `bsc`, `tron`, `sepolia` |
| `type`     | Currency type (e.g., `ERC20`, `ETH`, `ISO4217`)                                                                                |
| `hash`     | For ERC20 tokens, same as `address`. For native tokens, a calculated hash.                                                     |
| `chainId`  | Chain ID of the network                                                                                                        |

## Adding a New Token

We welcome community contributions! To add a new token to the list:

<Steps>
  <Step>
    Fork the [request-token-list](https://github.com/RequestNetwork/request-token-list) repository on Github
  </Step>

  <Step>
    Add your token information to `tokens/token-list.json`
  </Step>

  <Step>
    Make sure your token meets our requirements (see [CONTRIBUTING.md](https://github.com/RequestNetwork/request-token-list/blob/main/CONTRIBUTING.md))
  </Step>

  <Step>
    Run tests locally: `npm test`
  </Step>

  <Step>
    Create a Pull Request
  </Step>
</Steps>