We refreshed our doc site!
Bookmarked links may have changed
Read release notesFaucets are essential for developers to quickly obtain testnet tokens, including native tokens like ETH and stablecoins like USDC, to fund their wallets on blockchain test networks for testing purposes.
Testnet tokens play a critical role in test network environments for two primary use cases:
Circle provides two faucets:
The following table describes the properties of each faucet:
Public Faucet | Developer Console Faucet | |
---|---|---|
Cost | Free and open for anyone to use. No account required. | Free and open for anyone to use. You must log in with your Circle developer to use the faucet. |
Supported Wallets | Any wallet on a supported blockchain test network, specified by wallet address. | Any wallet generated using Circle’s developer platform (via API or UI), specified by Wallet ID. |
Tokens sent per request | Stablecoins • USDC: 10 • EURC: 10 | Stablecoins • USDC: 20 Native tokens • ARB: 0.1 • AVAX: 4 • ETH: 0.01 • MATIC: 0.2 • SOL: 0.001 |
Request limits | One request every 24 hours for USDC per testnet. One request every 24 hours for EURC per testnet. | Ten requests per developer account or team every 24 hours. |
Supported Testnets | • Algorand TestNet • Arbitrum Sepolia • Avalanche Fuji • Base Sepolia • Celo Alfajores • Ethereum Sepolia • Flow Testnet • Hedera Testnet • NEAR Testnet • Noble Testnet • OP Sepolia • Polygon PoS Amoy • Polkadot Westend • Solana Devnet • Stellar Testnet | • Arbitrum Sepolia • Avalanche Fuji • Ethereum Sepolia • Polygon PoS Amoy • Solana Devnet |
Use the Public Faucet to send USDC and EURC to your testnet wallets. To request tokens, go to faucet.circle.com.
Use the Developer Console Faucet to send USDC, AVAX, ETH, and MATIC to your testnet wallets generated using Circle’s developer platform. To request tokens, navigate to console.circle.com/faucet.
Use the steps in the following sections to get the ID of the wallet to send tokens to.
To acquire a wallet ID programmatically, use an API request to GET /v1/w3s/wallets to retrieve a list of wallets in your account.
To fund your wallets programmatically, submit a request to [POST /v1/faucet/drips](/api-reference/w3s/config/request-testnet-tokens)
.
curl --request POST \
--url https://api.circle.com/v1/faucet/drips \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TEST_API_KEY:XXX' \
--header 'Content-Type: application/json' \
--data '
{
"address": "0x...",
"blockchain": "MATIC-AMOY",
"native": true,
"usdc": true,
"eurc": true
}
'