Skip to main content

​
Overview

Token Layer provides a full-featured testnet environment where you can practice creating tokens, trading, and using all platform features without risking real funds.

​
Accessing Testnet

Visit the testnet application at:

​
Supported Testnet Networks

Token Layer testnet supports multiple test networks:

​
Active Testnets

Base Sepolia

Ethereum L2 testnet
  • Chain ID: 84532
  • Stablecoin: USDTL (18 decimals)
  • DEX: Uniswap V3

BNB Testnet

BNB Smart Chain testnet
  • Chain ID: 97
  • Stablecoin: USDTL (18 decimals)
  • DEX: PancakeSwap

Solana Devnet

Solana test network
  • Stablecoin: USDC (6 decimals)
  • DEX: Meteora

​
Getting Testnet Tokens

​
1. Get Native Tokens (Gas)

You need native tokens for gas fees: Base Sepolia ETH: BNB Testnet BNB: Solana Devnet SOL:

​
2. Get Test Stablecoins

Token Layer provides a faucet to mint test stablecoins (USDTL):
1

Connect Wallet

Connect your wallet to testnet at app-testnet.tokenlayer.network
2

Navigate to Faucet

Find the “Faucet” or “Get Test USDTL” option in the interface
3

Select Network

Choose which testnet you want USDTL on (Base Sepolia, BNB Testnet, etc.)
4

Mint Tokens

Click “Mint” to receive test stablecoins in your wallet
You can mint up to 10,000 USDTL per request. If you need more, simply use the faucet multiple times.

​
API Faucet Access

You can also mint test tokens via API:

Mint USD Testnet Tokens API

Programmatically mint test stablecoins

​
Testing Features

​
Creating Test Tokens

Practice token creation on testnet:
  1. Go to app-testnet.tokenlayer.network
  2. Click “Create Token”
  3. Fill in token details (use test data)
  4. Deploy on your chosen testnet
  5. Experiment with different launchpad settings
See How to Launch Tokens for detailed steps.

​
Trading Test Tokens

Test the trading experience:
  1. Browse or search for test tokens
  2. Practice buying with test USDTL
  3. Try selling tokens back
  4. Experiment with different trade sizes
  5. Observe price impact and slippage
See How to Trade for detailed trading instructions.

​
Testing API Integration

Test your API integration on testnet: 
// Example: Test API call on testnet
const response = await fetch('https://api.tokenlayer.network/get-tokens', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filter: 'trending',
    testnet: true  // Flag for testnet data
  })
});

​
Testnet vs Mainnet Differences

​
What’s the Same

✅ Full token creation flow ✅ Complete trading functionality ✅ Portfolio tracking ✅ Fee calculations ✅ API endpoints and responses ✅ User interface and experience

​
What’s Different

⚠️ No real value (all tokens are test tokens) ⚠️ May have different liquidity profiles ⚠️ Testnet-specific contract addresses ⚠️ Separate user accounts/data from mainnet

​
Best Practices

Test Thoroughly

Test all features you plan to use before mainnet

Simulate Real Scenarios

Use realistic token parameters and trade sizes

Save Contract Addresses

Note that testnet addresses differ from mainnet

Document Issues

Report any issues you find to help improve the platform

​
Testnet Limitations

Testnet has the same risk disclosures as mainnet. While using test funds, the smart contracts are still pre-audit. See Risks for details.
Known Limitations:
  • Testnet may be slower than mainnet
  • Faucets have rate limits
  • Data may be periodically wiped
  • Not all mainnet features may be available

​
Transitioning to Mainnet

Once you’re comfortable on testnet:
1

Switch to Mainnet

Navigate to tokenlayer.network
2

Use Real Funds

Ensure you have real stablecoins and gas tokens
3

Update API URLs

Point your API integration to mainnet endpoints
4

Start Small

Begin with small amounts on mainnet before scaling up

​
API Testing

All API endpoints work on testnet using the same base URL. Include testnet chain identifiers:
  • base-sepolia instead of base
  • bnb-testnet instead of bnb
  • solana-devnet instead of solana
Example: 
{
  "chainSlug": "base-sepolia",
  "tokenId": "test-token-id"
}

​
Need Help?

Click the chat icon in the bottom right corner for testnet support.