Skip to main content
POST
/
faucet
curl -X POST https://api.convallax.com/faucet \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "0xYourWallet..." }'

{
  "success": true,
  "amount": 1000,
  "txHash": "0xabc123...",
  "message": "Sent 1000 USDC to 0xYourWallet..."
}
Request testnet USDC for a wallet on Polygon Amoy. The relay transfers USDC from the market maker pool to the specified address. Rate-limited to prevent abuse.
​
wallet
string
required
The wallet address to receive testnet USDC (checksummed hex).
​
success
boolean
Whether the drip was successful.
​
amount
number
Amount of USDC sent (e.g. 1000).
​
txHash
string
Transaction hash on Polygon Amoy.
​
message
string
Human-readable confirmation message.
curl -X POST https://api.convallax.com/faucet \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "0xYourWallet..." }'

{
  "success": true,
  "amount": 1000,
  "txHash": "0xabc123...",
  "message": "Sent 1000 USDC to 0xYourWallet..."
}
The faucet drips 1,000 USDC per request. Each wallet is rate-limited to one request per 24 hours. Returns a 429 status if the cooldown hasn’t elapsed.
The faucet requires on-chain environment variables to be configured on the relay. If not configured, the endpoint returns a 503 error.