curl --request POST \
  --url https://testnet.walletkit.com/tokens/batch-transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "network": "Ethereum",
  "from": "<string>",
  "token": "<string>",
  "transfers": [
    {
      "recipient": "<string>",
      "amount": "<string>"
    }
  ],
  "developer_secret": "<string>",
  "user_pin": "<string>"
}'
{
  "transaction_id": "<string>",
  "network": "Ethereum",
  "status": "<string>"
}

Headers

X-WalletKit-Project-ID
string
required

Your WalletKit Project ID can be found on the API Keys page in the WalletKit Dashboard.

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
network
enum<string>
required
Available options:
Ethereum,
Polygon,
Base,
Avalanche,
Polkadot,
Vara
from
string
required

from address of the transfer

token
string
required

token contract address or symbol in case of the gas token to be transferred.

transfers
object[]
required

transfers in this batch, max batch size is 50 transfers.

developer_secret
string | null

On testnet, the developer_secret is always "testnet-secret". On mainnet, the developer_secret is set by the developer during account activation.

user_pin
string | null

A 6-digit numeric pin that is only known to the user, set during wallet creation. This pin is required to sign transactions from this wallet.

Response

200 - application/json
transaction_id
string
required
network
enum<string>
required
Available options:
Ethereum,
Polygon,
Base,
Avalanche,
Polkadot,
Vara
status
string
required