Request Network Token List

The Request Network Token List 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

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
}

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 (e.g., mainnet, matic, bsc, tron)
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:

1. Fork the request-token-list repository on Github

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

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

4. Run tests locally: npm test

5. Create a Pull Request