Airdrop

Endpoint

POST /airdrop

Request one or more testnet token airdrops in a single call. Testnet only.

Request Body

{
  "airdrops": [
    { "chainId": 84532, "tokenId": "spiceUsd", "amount": "200000000000000000000" }
  ],
  "tag": "optional-label"
}

Field	Type	Required	Description
`airdrops`	`array`	Yes	Non-empty array of airdrop requests
`airdrops[].chainId`	`number`	Yes	Target chain ID
`airdrops[].tokenId`	`string`	Yes	Token identifier (see below)
`airdrops[].amount`	`string`	Yes	Amount in base units, as a string
`tag`	`string`	No	Optional label for the batch

Supported Token IDs

Token ID	Description	Example chains
`spiceUsd`	Test USD	Base Sepolia (84532), Arbitrum Sepolia (421614)
`mWBTC`	Test WBTC	Testnet chains

Verified example token addresses for spiceUsd: Base Sepolia 0xf370dC3765f81aC9dD2FEBd59Fb4e710330B0BC8, Arbitrum Sepolia 0xBeB51deb2018b67b35d5695Fd15bb30D452c7868.

Response

Success (200) returns the per-request results (amount airdropped and the airdrop transaction hash for each entry).

Error Responses

400 Bad Request (validation), for example:

{ "success": false, "error": { "message": "airdrops must be a non-empty array" } }

{ "success": false, "error": { "message": "airdrops[0].tokenId unknownToken is not supported" } }

Example

curl -X POST https://tx-submission-api.spicenet.io/airdrop \
  -H "Content-Type: application/json" \
  -d '{ "airdrops": [ { "chainId": 84532, "tokenId": "spiceUsd", "amount": "200000000000000000000" } ] }'

Whitelist

A separate POST /airdrop/whitelist endpoint records a wallet against a tag:

curl -X POST https://tx-submission-api.spicenet.io/airdrop/whitelist \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "0x...", "tag": "campaign-x" }'

Notes

Testnet only, not available on mainnet.

Overview

Actions API

Balances & Deposits

Transaction Tracking

Utility

Legacy

Endpoint

Request Body

Supported Token IDs

Response

Error Responses

Example

Whitelist

Notes

​Endpoint

​Request Body

​Supported Token IDs

​Response

​Error Responses

​Example

​Whitelist

​Notes

Endpoint

Request Body

Supported Token IDs

Response

Error Responses

Example

Whitelist

Notes