Skip to main content
POST
/
v2
/
evm
/
faucet
Request funds on EVM test networks
curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v2/evm/faucet \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "network": "base-sepolia",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "token": "eth"
}'
{
  "transactionHash": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

Authorizations

​
Authorization
string
header
required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Body

application/json
​
network
enum<string>
required

The network to request funds from.

Available options:
base-sepolia,
ethereum-sepolia,
ethereum-hoodi
Example:

"base-sepolia"

​
address
string
required

The address to request funds to, which is a 0x-prefixed hexadecimal string.

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

​
token
enum<string>
required

The token to request funds for.

Available options:
eth,
usdc,
eurc,
cbbtc
Example:

"eth"

Response

Successfully requested funds.

​
transactionHash
string
required

The hash of the transaction that requested the funds. Note: In rare cases, when gas conditions are unusually high, the transaction may not confirm, and the system may issue a replacement transaction to complete the faucet request. In these rare cases, the transactionHash will be out of sync with the actual faucet transaction that was confirmed onchain.

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"