Testnet Faucet API

The testnet faucet provides free BADGE tokens for testing. No API key is required on testnet, and CORS restrictions are relaxed.

Endpoint

POST https://api.bitbadges.io/testnet/api/v0/faucet

Request

{
  "address": "bb1..."
}

The address must be in BitBadges (bb1...) format. Use the SDK's convertToCosmosAddress() to convert from Ethereum or other formats if needed.

Response

Success (200): Empty response body. Tokens are queued for delivery and will arrive shortly.

Error (500): JSON error response. Common errors:

Error
Cause

Already_airdropped

This address has already received faucet tokens

Invalid_request._Origin_not_found.

Could not determine request origin

Behavior

  • Amount: 1000 ubadge per request

  • Limit: 1 airdrop per address (lifetime)

  • Processing: Asynchronous queue - tokens may take a few seconds to arrive

  • Authentication: None required on testnet

Examples

cURL

SDK (TypeScript)

Bot Pattern

Notes

  • The faucet is testnet-only. On mainnet, acquire BADGE through normal channels.

  • Each address can only use the faucet once. If you need more tokens, use a different address or contact the team on Discord.

  • See Testnet Mode for full testnet environment details.

Last updated