request-network-token-list.md

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

The token list is available at: https://requestnetwork.github.io/request-token-list/latest.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 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)
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

See the SDK source code for the full list of supported networks and types.

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