Testnet Faucet
Claim testnet USDC or USDT on supported blockchains for development and testing.
The Testnet Faucet sends free testnet stablecoins to an address, so you can test transfers in Sandbox. Testnet tokens have no real value.
Sandbox Only
The faucet is only available in Sandbox (
harbor-sandbox.owlpay.com). In Production, requests return error7004.
| Action | Endpoint |
|---|---|
| Claim testnet funds | POST /api/v1/applications/faucet |
How It Works
The faucet sends testnet funds to your own wallet. You then pay the transfer from that wallet.
- Claim testnet USDC to your own wallet.
- Create the transfer with your own wallet as the source. It gives you an address to pay, the
instruction_address. - Send the USDC from your wallet to that address.
sequenceDiagram
participant Faucet
participant Wallet as Your wallet
participant Harbor
Faucet->>Wallet: 1. Testnet USDC
Wallet->>Harbor: 2. Create the transfer, your wallet as the source
Harbor->>Wallet: 3. instruction_address
Wallet->>Harbor: 4. USDC to the instruction_address
Supported Chains
Use the chain value in the request, and connect your wallet to the testnet.
| Chain | chain | Currency | Testnet |
|---|---|---|---|
| Ethereum | ethereum | USDC and USDT | Sepolia |
| Polygon | polygon | USDC | Amoy |
| Arbitrum | arbitrum | USDC | Arbitrum Sepolia |
| Avalanche | avalanche | USDC | Fuji |
| Optimism | optimism | USDC | OP Sepolia |
| Base | base | USDC | Base Sepolia |
| Solana | solana | USDC | Devnet |
| Stellar | stellar | USDC | Testnet |
Ethereum, Polygon, Arbitrum, Avalanche, Optimism and Base use the same 0x address format. For the formats, see EVM vs. Solana vs. Stellar.
USDC contract addresses
To see the balance, import USDC into your wallet with its contract address. Solana calls it the mint, and Stellar the issuer. USDC has 6 decimals, except on Stellar, which has 7.
| Chain | USDC contract address |
|---|---|
| Ethereum | 0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238 |
| Polygon | 0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582 |
| Arbitrum | 0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d |
| Avalanche | 0x5425890298aed601595a70ab815c96711a31bc65 |
| Optimism | 0x5fd84259d66Cd46123540766Be93DFE6D43130D7 |
| Base | 0x036CbD53842c5426634e7929541eC2318f3dCF7e |
| Solana | 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU (mint) |
| Stellar | GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 (issuer) |
Claim Testnet Funds
Pick the tab that matches your wallet:
curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v1/applications/faucet' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--data-raw '{
"currency": "USDC",
"chain": "ethereum",
"address": "0x76da4165da3d87b0dfcfeb867a31a0d7ab9884a5",
"amount": "100.00"
}'curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v1/applications/faucet' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--data-raw '{
"currency": "USDT",
"chain": "ethereum",
"address": "0x76da4165da3d87b0dfcfeb867a31a0d7ab9884a5",
"amount": "100.00"
}'curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v1/applications/faucet' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--data-raw '{
"currency": "USDC",
"chain": "solana",
"address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
"amount": "100.00"
}'curl --location --request POST 'https://harbor-sandbox.owlpay.com/api/v1/applications/faucet' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-API-KEY: {{API_KEY}}' \
--data-raw '{
"currency": "USDC",
"chain": "stellar",
"address": "GBZXN7PIRZGNMHGA7MUUUF4GWPY5AYPV6LY4UV2GL6VJGIQRXFDNMADI",
"amount": "100.00"
}'- Required:
currency(USDCorUSDT),chain,addressandamount. - Optional:
address_tag, a memo. Only for a shared or custodial address that needs one. Leave it out for your own wallet. amountis from0.01to500.00, with up to 2 decimal places.
Response
The response shows your quota after the claim:
{
"chain": "ethereum",
"currency": "USDC",
"address": "0x76da4165da3d87b0dfcfeb867a31a0d7ab9884a5",
"amount": "100.00",
"daily_used": "100.00",
"daily_remaining": "400.00",
"daily_limit": "500.00",
"reference_id": "0x8d9708414c21af3d07dc5118e9b3f388bcd52374e1e264327cf4cbb73987fd0c"
}reference_id: tracks the payout. On EVM chains, it is the on-chain transaction hash. Look it up on a block explorer.daily_used,daily_remaininganddaily_limit: your quota. There is no separate quota endpoint.
Daily Quota
Each application can claim up to 500 per chain and currency, per day.
- Each chain and currency has its own quota. USDC on Ethereum and USDT on Ethereum are tracked separately.
- Quotas reset at midnight UTC.
- If a payout fails, the amount isn't taken from your quota.
A claim over your remaining quota returns error 7001, with your quota in details:
{
"message": "Daily limit exceeded. Remaining: 400.00 USDC",
"error": "Daily limit exceeded. Remaining: 400.00 USDC",
"code": 7001,
"error_type": "faucet.daily_limit_exceeded",
"details": {
"daily_limit": "500.00",
"daily_used": "100.00",
"daily_remaining": "400.00"
}
}Errors
What each error means and what to do.
| Code | Meaning | What to do |
|---|---|---|
2005 | Invalid request | Check errors. For example, USDT on a chain other than Ethereum, or an amount above 500. |
7001 | Daily limit exceeded | Claim a smaller amount, or wait for the reset at midnight UTC. |
7002 | Circle recipient registration failed | USDC only. Retry the request. |
7003 | Circle payout creation failed | USDC only. Retry the request. |
7004 | Production environment blocked | Use Sandbox. |
7005 | USDT chain not supported | Use ethereum as the chain for USDT. |
7006 | Faucet payout failed | USDT only. Retry the request. |
FAQ
Common questions.
Can I use the same address on multiple chains?
Yes, on EVM chains (Ethereum, Polygon, Arbitrum, Avalanche, Optimism, Base) you can use the same 0x address. The funds stay on the chain you claimed on, so claim on the chain your transfer uses. Stellar and Solana need their own address formats.
Is there a rate limit on top of the daily quota?
The standard API rate limits apply. The faucet has no extra per-minute limit.
Notes
- Chain: claim on the same chain as the transfer's
source.chain. A balance on one chain doesn't appear on another, and the transfer stays unpaid. - Sender and amount: send from the wallet you set as
source.payment_instrument.address, and send the fullsource.amount. A smaller amount leaves the transfer unpaid until it expires. - Stellar: the account must exist and have a USDC trustline for the issuer above, or the claim fails. Fund a new account with testnet XLM from the Stellar Friendbot, then add the trustline.
- The legacy endpoint
POST /api/v1/applications/faucet/usdc(USDC only) still works for existing integrations. New integrations should use/api/v1/applications/faucet, which also supports USDT.
Updated about 1 month ago