Request Network Token List

Usage

Request Token List JSON

Access the latest published token list JSON.

You can fetch the token list directly in your application:

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.

GET /v2/currencies

Query currencies with optional filters (network, symbol, id).

GET /v2/currencies/{currencyId}/conversion-routes

Fetch payment currencies available for a specific invoice currency.

Token List Structure

Each token in the list contains the following information:

{
  "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...):

{
  "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:

Fork the request-token-list repository on Github

Add your token information to tokens/token-list.json

Make sure your token meets our requirements (see CONTRIBUTING.md)

Run tests locally: npm test

Create a Pull Request

🌐 Developer Resources

🛠️ Tools

🏗️ Architecture

📖 Documentation

Usage

Request Token List JSON

Token List vs Currencies API

GET /v2/currencies

GET /v2/currencies/{currencyId}/conversion-routes

Token List Structure

Adding a New Token

​Usage

Request Token List JSON

​Token List vs Currencies API

GET /v2/currencies

GET /v2/currencies/{currencyId}/conversion-routes

​Token List Structure

​Adding a New Token

Usage

Token List vs Currencies API

Token List Structure

Adding a New Token