Documentation Index
Fetch the complete documentation index at: https://spiceflow-docs.spicenet.io/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
POST /airdrop/:chainId/:tokenId
Path Parameters
| Parameter | Type | Required | Description |
|---|
chainId | number | Yes | Target chain ID |
tokenId | string | Yes | Token identifier |
Supported Tokens
| Token ID | Chain | Chain ID | Token Address |
|---|
spiceUsd | Base Sepolia | 84532 | 0xf370dC3765f81aC9dD2FEBd59Fb4e710330B0BC8 |
spiceUsd | Arbitrum Sepolia | 421614 | 0xBeB51deb2018b67b35d5695Fd15bb30D452c7868 |
Request Body
{
"wallet": "0xYourWalletAddress..."
}
| Field | Type | Required | Description |
|---|
wallet | string | Yes | Recipient wallet address |
Response
Success (200)
{
"airdropAmount": "200000000000000000000",
"txHash": "0x..."
}
| Field | Type | Description |
|---|
airdropAmount | string | Amount airdropped (in wei) |
txHash | Hash | Transaction 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
}
{
"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
