Skip to main content

​
Overview

  • Learn how to obtain testnet tokens from Circle’s Public Faucet or Developer Console Faucet.
  • Locate a wallet ID in the Developer Console, retrieve one via the API, and fund programmatically.

​
Prerequisites

Before you begin:
  • You have a testnet wallet. For the Developer Console Faucet, this must be a wallet created on Circle’s developer platform.
  • For the Developer Console Faucet, you have a Circle developer account.
  • Review Testnet Faucets to confirm which faucet supports your target testnet and token.

​
Steps

​
Step 1. Choose a faucet

Two faucets are available:
  • Public Faucet (faucet.circle.com): accepts a wallet address. No account required. Supports USDC and EURC.
  • Developer Console Faucet (console.circle.com/faucet): accepts a wallet ID. Requires a Circle developer account. Supports native tokens and USDC.
If you are using the Public Faucet, paste your wallet address directly into the form and skip to Step 3. If you are using the Developer Console Faucet, you need a wallet ID. Continue to Step 2.

​
Step 2. Get your wallet ID

​
From the Developer Console

Use the instructions for your wallet type.
User-controlled wallets
  1. Navigate to User Controlled > Users.
  2. Click a user to view their details.
  3. Click a wallet to view its details. Confirm the network matches the testnet you plan to fund.
  4. Click the copy icon in the Wallet ID field.
Developer-controlled wallets
  1. Navigate to Dev Controlled > Wallets.
  2. Click a wallet to view its details. Confirm the network matches the testnet you plan to fund.
  3. Click the copy icon in the Wallet ID field.
Console wallets
  1. Navigate to Console Wallets.
  2. Click a wallet to view its details. Confirm the network matches the testnet you plan to fund.
  3. Click the copy icon in the Wallet ID field.

​
Via the API

To retrieve a wallet ID programmatically, call GET /v1/w3s/wallets to list the wallets in your account.

​
Step 3. Request tokens

To fund a wallet programmatically, submit a request to POST /v1/faucet/drips.
Calling the /v1/faucet/drips API requires upgrading to mainnet.
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
}
'