Skip to main content

​
Endpoint

POST /airdrop/:chainId/:tokenId

​
Path Parameters

ParameterTypeRequiredDescription
chainIdnumberYesTarget chain ID
tokenIdstringYesToken identifier

​
Supported Tokens

Token IDChainChain IDToken Address
spiceUsdBase Sepolia845320xf370dC3765f81aC9dD2FEBd59Fb4e710330B0BC8
spiceUsdArbitrum Sepolia4216140xBeB51deb2018b67b35d5695Fd15bb30D452c7868

​
Request Body

{
  "wallet": "0xYourWalletAddress..."
}
FieldTypeRequiredDescription
walletstringYesRecipient wallet address

​
Response

Success (200) 
{
  "airdropAmount": "200000000000000000000",
  "txHash": "0x..."
}
FieldTypeDescription
airdropAmountstringAmount airdropped (in wei)
txHashHashTransaction hash of the airdrop

​
Error Responses

400 Bad Request 
{
  "error": "unsupported chain id",
  "chainId": "999"
}

{
  "error": "unsupported token id",
  "tokenId": "unknownToken"
}

{
  "error": "wallet must be string",
  "wallet": null
}
500 Internal Server Error 
{
  "error": "faucet out of funds for for chain id, token id",
  "chainId": "84532",
  "tokenId": "spiceUsd",
  "tokenAddress": "0x...",
  "faucetAddress": "0x...",
  "faucetBalance": "0",
  "airdropAmount": "200000000000000000000"
}

​
Example

curl -X POST /airdrop/84532/spiceUsd \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0x742d35Cc6634C0532925a3b844e4B7db0D6d8E5c"}'

​
Notes

  • Fixed airdrop amount: 200 tokens per request
  • Testnet only - not available on mainnet