Testnet Faucets

Faucets 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:

• Cover network gas fees: Use native tokens like ETH to pay network gas fees for testnet transactions.
• Validate smart contract functionality: Experiment with funds flows in your smart contracts to validate behavior and support for specific digital assets.

Circle provides two faucets:

• Public Faucet: Distributes USDC and EURC on supported blockchain test networks.
• Developer Console Faucet: Distributes native tokens like AVAX, ETH, and MATIC, and stablecoins like USDC. To access the Developer Console faucet, you must log in with your Circle developer account.

The following table describes the properties of each faucet:

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.

1. Navigate to User Controlled > Users.
2. Click on a user to view the user details.
3. Click on a wallet to view the wallet details. Confirm the network displayed matches the network you plan to send tokens to.
4. Click the copy icon in the Wallet ID field.

1. Navigate to Dev Controlled > Wallets.
2. Click on a wallet to view the wallet details. Confirm the network displayed matches the network you plan to send tokens to.
3. Click the copy icon in the Wallet ID field.

1. Navigate to Console Wallets.
2. Click on a wallet to view the wallet details. Confirm the network displayed is the network you plan to send tokens to.
3. Click the copy icon in the Wallet ID field.

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.

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
}
'