Skip to main content

Faucet Service

Distributes testnet GHOST tokens to developer addresses. One claim per address.

Endpoints​

Claim tokens​

POST /api/faucet/claim
{ "address": "0xYourEVMAddress" }

Response (success):

{
  "success": true,
  "txHash": "0xabc123...",
  "amount": "100000000000000000000"
}

Response (already claimed):

{
  "error": "Address has already claimed",
  "claimedAt": "2025-01-15T10:30:00.000Z"
}

Check status​

GET /api/faucet/status?address=0xYourAddress

Response:

{
  "address": "0xYourAddress",
  "claimed": true,
  "claimedAt": "2025-01-15T10:30:00.000Z",
  "txHash": "0xabc123..."
}

Health check​

GET /health

Configuration​

ParameterValue
Port3005
Drip amount100 GHOST
Claims per address1
Claim rate limit5 requests/minute/IP
Status rate limit15 requests/minute/IP

No authentication required​

The faucet is publicly accessible. Rate limiting prevents abuse.

Public URL​

https://relayer.specterchain.com/api/faucet/claim
https://relayer.specterchain.com/api/faucet/status?address=0x...