Faucet

Faucet Claim

Claim daily USDB from the treasury. The claim amount is based on your tier, streak, and referral signals. Requires SIWE session authentication.

POST
/api/v1/faucet/claim
Claim daily USDB. Optionally pass a referrer address.
Auth: SIWE Session required

Request Body

Response
{
  "referrer": "0x..."   // optional — referrer wallet address
}

Response

Response
{
  "success": true,
  "amount": "13500000000000000000",
  "txHash": "0x...",
  "signals": {
    "base": 10,
    "streak": 2,
    "tier": 1,
    "referral": 0.5
  }
}
200 Claimed400 Invalid request401 Not authenticated403 Wallet blocked429 Cooldown active / daily limit / rate limited