Sign in

v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Wallets

Send Tokens

Send tokens to multiple recipients in a single transaction batch. Supports native tokens (ETH, MATIC, etc.), ERC20 tokens, ERC721 NFTs, and ERC1155 tokens. The token type is automatically determined based on the provided parameters and ERC165 interface detection:

  • Native Token: No tokenAddress provided
  • ERC20: tokenAddress provided, no tokenId
  • ERC721/ERC1155: tokenAddress and tokenId provided. Auto detects contract type:
    • ERC721: quantity must be '1'
    • ERC1155: any quantity allowed (including '1')

Authentication: This endpoint requires project authentication and wallet authentication. For backend usage, use x-secret-key header. For frontend usage, use x-client-id + Authorization: Bearer <jwt> headers.

post/v1/wallets/send

Request body

fromstring

The wallet address or ENS name that will send the tokens. If omitted, the project wallet will be used if available.

chainIdinteger required

The blockchain network identifier where the transfer will be executed.

tokenAddressstring

The token contract address. Omit for native token (ETH, MATIC, etc.) transfers.

tokenIdstring

The token ID for NFT transfers (ERC721/ERC1155). Required for NFT transfers.

Example request

{
  "from": "0x1234567890123456789012345678901234567890",
  "chainId": 1,
  "recipients": [
    {
      "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "quantity": "1000000000000000000"
    },
    {
      "address": "0x1111111111111111111111111111111111111111",
      "quantity": "500000000000000000"
    }
  ]
}

Response

Tokens sent successfully. Returns transaction IDs for tracking and monitoring.