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 error 7004.

ActionEndpoint
Claim testnet fundsPOST /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.

ChainchainCurrencyTestnet
EthereumethereumUSDC and USDTSepolia
PolygonpolygonUSDCAmoy
ArbitrumarbitrumUSDCArbitrum Sepolia
AvalancheavalancheUSDCFuji
OptimismoptimismUSDCOP Sepolia
BasebaseUSDCBase Sepolia
SolanasolanaUSDCDevnet
StellarstellarUSDCTestnet

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.

ChainUSDC contract address
Ethereum0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
Polygon0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582
Arbitrum0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d
Avalanche0x5425890298aed601595a70ab815c96711a31bc65
Optimism0x5fd84259d66Cd46123540766Be93DFE6D43130D7
Base0x036CbD53842c5426634e7929541eC2318f3dCF7e
Solana4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU (mint)
StellarGBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 (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"
}'
  • Required: currency (USDC or USDT), chain, address and amount.
  • Optional: address_tag, a memo. Only for a shared or custodial address that needs one. Leave it out for your own wallet.
  • amount is from 0.01 to 500.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_remaining and daily_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.

CodeMeaningWhat to do
2005Invalid requestCheck errors. For example, USDT on a chain other than Ethereum, or an amount above 500.
7001Daily limit exceededClaim a smaller amount, or wait for the reset at midnight UTC.
7002Circle recipient registration failedUSDC only. Retry the request.
7003Circle payout creation failedUSDC only. Retry the request.
7004Production environment blockedUse Sandbox.
7005USDT chain not supportedUse ethereum as the chain for USDT.
7006Faucet payout failedUSDT 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 full source.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.

Did this page help you?