Farbeam
Docs / Data

Curated tokens

The index reads a short fixed list of tokens per chain. It is declared in the service config and is the same list the API returns under tokens[] from List chains. A test script calls decimals() on each EVM contract and compares the result with the list.

The list holds stablecoins and major wrapped assets. It is short on purpose: each token adds to the size of every log call, and public RPC providers limit those calls.

#Full list

#Ethereum

SymbolAddressDecimalsPrice id
USDC0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB486usd-coin
USDT0xdAC17F958D2ee523a2206206994597C13D831ec76tether
WETH0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc218ethereum
WBTC0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C5998wrapped-bitcoin
DAI0x6B175474E89094C44Da98b954EedeAC495271d0F18dai

#Base

SymbolAddressDecimalsPrice id
USDC0x833589fCD6eDb6E08f4c7C32D4f71b54bdA029136usd-coin
WETH0x420000000000000000000000000000000000000618ethereum
USDbC0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA6usd-coin
cbBTC0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf8wrapped-bitcoin
DAI0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb18dai

#BNB Chain

SymbolAddressDecimalsPrice id
USDT0x55d398326f99059fF775485246999027B319795518tether
USDC0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d18usd-coin
WBNB0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c18binancecoin
BTCB0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c18wrapped-bitcoin
ETH0x2170Ed0880ac9A755fd29B2688956BD959F933F818ethereum

#Arbitrum One

SymbolAddressDecimalsPrice id
USDC0xaf88d065e77c8cC2239327C5EDb3A432268e58316usd-coin
USDT0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb96tether
WETH0x82aF49447D8a07e3bd95BD0d56f35241523fBab118ethereum
WBTC0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f8wrapped-bitcoin

#OP Mainnet

SymbolAddressDecimalsPrice id
USDC0x0b2C639c533813f4Aa9D7837CAf62653d097Ff856usd-coin
USDT0x94b008aA00579c1307B0EF2c499aD98a8ce58e586tether
WETH0x420000000000000000000000000000000000000618ethereum

#Polygon PoS

SymbolAddressDecimalsPrice id
USDC0x3c499c542cEF5E3811e1192ce70d8cC03d5c33596usd-coin
USDT0xc2132D05D31c914a87C6611C10748AEb04B58e8F6tether
WETH0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f61918ethereum

#Solana

SymbolMintDecimalsPrice id
USDCEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6usd-coin
USDTEs9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB6tether
wSOLSo111111111111111111111111111111111111111129solana
JUPJUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN6jupiter-exchange-solana
BONKDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB2635bonk
WIFEKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm6dogwifcoin
JTOjtojtomepa8beP8AuQc6eXt5FriJwfFMwQx2v2f9mCL9jito-governance-token
PYTHHZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt36pyth-network
RAY4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R6raydium
JitoSOLJ1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn9jito-staked-sol
mSOLmSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So9msol

#Where the list applies

FeatureUses the curated list
Large-transfer indexYes. Other tokens are not stored.
Beamline rulesYes, because rules match indexed rows.
GET /wallets/{address} on EVMYes. Balances are read for these tokens only.
GET /wallets/{address}/activity on EVMYes. Logs are read for these tokens only.
GET /wallets/{address} on SolanaNo. All fungible tokens are read, and the top 60 are returned.
GET /tokens/{chain}/{address}No. Any token address works.
GET /tx/{chain}/{hash}No. All standard token logs in the transaction are decoded.

On OP Mainnet and Polygon, the list serves wallet reads only, since those chains have no index.

#Symbols across chains

Symbols repeat. USDC on Ethereum and USDC on Base are different contracts, and the token filter on /transfers matches on the symbol alone.

curl
# All chains
curl -s "https://farbeamlabs.com/api/v1/transfers?token=USDC&limit=5"
# One chain
curl -s "https://farbeamlabs.com/api/v1/transfers?token=USDC&chain=base&limit=5"

In Beamline, use token_address to pin one contract:

Beamline
token_address == "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

#Requesting a token

There is no self-service way to add a token. Write to contact@farbeamlabs.com with the chain, the address and the reason. Each addition adds load on the log calls, so the list will stay short. Listing here is not a recommendation of any token, and Farbeam makes no statement on the quality of the assets on this list. The token report reads the same public checks for curated and other tokens.