Skip to main content

Faucet

The Faucet provides test NAI tokens for developers to use on the testnet.

Base URL: https://faucet-testnet.nuklaivm.com/

Faucet Endpoints​

1. POST /request​

Sends tokens to a specified Nuklai address.

Request:

{
  "address": "nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h"
}

Response:

{
  "success": true,
  "txHash": "5A4B7C8D9E0F1A2B3C4D5E6F7A8B9C0D1E2F3A4B",
  "amount": "1000000nai",
  "displayAmount": "1 NAI",
  "txUrl": "https://api-testnet.nuklaivm.com/cosmos/tx/v1beta1/txs/5A4B7C...",
  "recipientAddress": "nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h"
}

Error Response:

{
  "success": false,
  "error": "Rate limit exceeded. Please try again in 2 minutes.",
  "code": 429
}

2. GET /health​

Returns faucet health information.

Response:

{
  "success": true,
  "status": "operational",
  "faucetAddress": "nuklai1faucetaddresshere",
  "balance": "10000000000nai",
  "displayBalance": "10,000 NAI",
  "distribution": "1000000nai",
  "displayDistribution": "1 NAI",
  "ipLimit": "2m0s",
  "addressLimit": "24h0m0s",
  "requestsRemaining": 5,
  "rateLimitsDisabled": false
}

Usage Examples​

Request NAI Tokens​

You can request test NAI to your address using the command below. Note that you can request a maximum of 5 times, then must wait for 2 minutes to request more.

curl -X POST https://faucet-testnet.nuklaivm.com/request \
  -H "Content-Type: application/json" \
  -d '{"address":"nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h"}'

Check Faucet Health​

curl https://faucet-testnet.nuklaivm.com/health

Verify Received Tokens​

After requesting tokens, you can verify your balance using:

curl https://api-testnet.nuklaivm.com/cosmos/bank/v1beta1/balances/nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h

Or using the nuklaid CLI:

nuklaid query bank balances nuklai13fy0hfyy5h9zxmkukfx48j0m84kyl7qpcljh5h --node https://rpc-testnet.nuklaivm.com:443

Rate Limiting​

  • IP-based rate limit: 5 requests per 2 minutes
  • Address-based rate limit: 10 requests per 24 hours
  • Fixed distribution amount: 1 NAI (1,000,000 nai)

GitHub.