Testnet Faucet

The faucet is the entry point for any new user or wallet on the YouthChain testnet. A single call delivers everything a user needs to start participating: native gas, the staking token, and the rewards token.

What you receive

Asset	Amount	Purpose
Native YCE	0.1 YCE	Gas for transactions
YCE token (ERC-20)	11,000 YCE	Staking, AMM, governance
YCR token (ERC-20)	1,000 YCR	Rewards token, AMM swap

The faucet wallet is funded with ~500K native YCE, ~100M YCE token and ~8M YCR. Enough headroom for thousands of testers.

Cooldown

24 hours per address. A second request from the same address within 24h returns HTTP 429 COOLDOWN. Use a fresh wallet (or the /api/faucet/status/:address endpoint to check) if you need more during testing.

Endpoints

`POST /api/faucet`

Drops YCE + YCR + native to the address. Request

curl -X POST https://api.54-237-170-237.sslip.io/api/faucet \
  -H 'Content-Type: application/json' \
  -d '{"address":"0xYOUR_ADDRESS"}'

Body

Field	Type	Required	Description
`address`	string	yes	EVM address (`0x` + 40 hex), case-insensitive

Response — 202 Accepted

{
  "ok": true,
  "pending": true,
  "txHash": "0x9732e38b53673b37bb5916d30405e3c4c9ae150cc1ff864e2047b20e8cf99611",
  "nativeTxHash": "0xc4644fc040587d9f25fb2b4e9a8360d7738083a24c1a1c2ec9ace9df2218580a",
  "ycrTxHash": "0xe480a39baaf298b0a3d159de9f109edb92bc9f9d1fbeb5aa44215bea09936b7e",
  "address": "0xc7ca30e9799c87b95bb646ccb4e4655d62d7d8f0",
  "amountYce": "11000",
  "amountYcr": "1000",
  "nativeWei": "100000000000000000",
  "pollUrl": "/api/faucet/status/0xc7ca30e9799c87b95bb646ccb4e4655d62d7d8f0",
  "message": "Queued 11000 YCE token + 1000 YCR token + 0.1 native YCE for gas..."
}

202, not 201: the response comes back before the money lands. The three transfers are submitted to the node immediately — the call answers in well under a second — and they settle a few blocks later. Measured on the testnet: balance visible ~15 s after the POST. Poll pollUrl every 5 s until nativeBalance is non-zero, or watch the three hashes with eth_getTransactionReceipt. See Events & confirmations.

This endpoint used to hold the connection open until all three receipts existed, which took around 40 s at a 5 s block time — past the default timeout of most HTTP clients, so a working faucet looked broken. If your client treats a slow response as an error, that workaround is no longer needed.

Errors

Status	Code	When
400	`INVALID_ADDRESS`	address is not 0x + 40 hex
429	`COOLDOWN`	address requested faucet within 24h. Body includes `retryAfter` (seconds)
500	`FAUCET_FAILED`	RPC error, faucet wallet drained, etc.

`GET /api/faucet/status/:address`

Checks whether an address is on cooldown and returns its current native balance. Request

curl https://api.54-237-170-237.sslip.io/api/faucet/status/0xYOUR_ADDRESS

Response — 200 OK

{
  "address": "0xc7ca30e9799c87b95bb646ccb4e4655d62d7d8f0",
  "claimed": true,
  "claimedAt": "2026-05-03T16:59:01.361Z",
  "onCooldown": true,
  "retryAfter": 84321,
  "nativeBalance": "100000000000000000"
}

Integration tips

Always call this first for any new wallet. Without native YCE the wallet can’t send any tx.
The 11K YCE is enough for: 10K stake to register as validator + 1K cushion for gas + AMM swaps.
The 1K YCR is enough to play with the AMM (swapYCRForYCE swaps 100 YCR for ~1.4 YCE at current pool ratio).
Cooldown is in-memory in the indexer — it resets if the indexer container restarts. Don’t rely on it for production rate-limiting.

API Reference

JSON-RPC (Ethereum-compatible)

Mobile REST API

Faucet

Block Endorsements

What you receive

Cooldown

Endpoints

`POST /api/faucet`

`GET /api/faucet/status/:address`

Integration tips

​What you receive

​Cooldown

​Endpoints

​POST /api/faucet

​GET /api/faucet/status/:address

​Integration tips

What you receive

Cooldown

Endpoints

`POST /api/faucet`

`GET /api/faucet/status/:address`

Integration tips