Faucets

Request testnet funds

Sends the network's drip amount to address. Requires a Cloudflare Turnstile token obtained from the faucet page for that network (https://www.alchemy.com/faucets/{faucetId}); there is no server-to-server credential for this endpoint.

Requests are rate limited per address per network, and are subject to anti-sybil checks against mainnet balance and activity. A rejection is not retryable until the stated condition changes: read statusCode rather than the message text.

Errors carry the legacy shape { "error": string, "statusCode": string }, where statusCode is one of missing_address, missing_turnstile, turnstile_failed, unsupported_faucet, invalid_request_body, invalid_address, insufficient_mainnet_balance, insufficient_mainnet_activity, max_balance_exceeded, rate_limit_exceeded, insufficient_faucet_balance, insufficient_faucet_balance_tx, nonce_conflict, or faucet_request_failed. Validation failures additionally carry a hint.

post/api/faucets/{faucetId}/send

Path parameters

faucetId'ethereum-sepolia' | 'arbitrum-sepolia' | 'base-sepolia' | 'optimism-sepolia' | 'polygon-amoy' | 'zksync-sepolia' | 'worldchain-sepolia' | 'soneium-minato' | 'hyperliquid-testnet' | 'monad-testnet' | 'shape-sepolia' | 'abstract-testnet' | 'crossfi-testnet' | 'lens-sepolia' | 'syndicate-risa' | 'gensyn-testnet' | 'humanity-testnet' | 'worldl3-devnet' | 'stable-testnet' | 'starknet-sepolia' | 'unichain-sepolia' | 'ink-sepolia' | 'robinhood-testnet' required

Network to draw from. Deprecated and no longer funded: syndicate-risa, starknet-sepolia.

Request body

addressstring required

Recipient address, 0x-prefixed and 20 bytes.

turnstileTokenstring required

Cloudflare Turnstile token from the faucet page for this network.

Response

Transaction submitted.

successboolean required
transactionHashstring required

Hash to pass to getFaucetTransactionStatus.

amountstring

Amount sent, in the network's native unit.

recipientstring
explorerUrlstring

Block explorer link, when the network has one.

statusCode'success' required

Changes