Spraay Batch Payments

Spraay batch payments

Send tokens to up to 200+ recipients in a single transaction. Spraay batch contracts are deployed across 15 chains with a live gateway at gateway.spraay.app.

Protocol fee: 0.3% of the total batch amount. Gas savings: ~80% compared to individual transfers.

When to use

• User wants to send crypto to multiple wallets at once
• User asks about payroll, airdrops, bounty distribution, or DAO payouts
• User mentions "batch payment", "multi-send", "mass transfer", or "spray"
• User needs to pay a list of addresses from a CSV or array

Batch types

Native token batch

Send ETH, MATIC, BNB, AVAX, SOL, XLM, XRP, BTC, TAO, or STX to multiple recipients in one transaction.

ERC-20 / SPL token batch

Send USDC, DAI, WETH, or any ERC-20 token (EVM chains) or SPL token (Solana) to multiple recipients. Automatic approval handling on EVM.

Equal-amount batch

Send the same amount to every recipient. Specify one amount and a list of addresses.

Variable-amount batch

Send different amounts to each recipient. Each entry has its own address and amount.

CSV import batch

Upload a CSV with columns address,amount for large-scale distributions (200+ recipients per transaction).

Supported chains

EVM chains (smart contract batch)

All EVM contracts are verified, use OpenZeppelin ReentrancyGuard and Pausable, and support up to 200+ recipients per transaction.

Non-EVM chains

Gateway endpoint

POST https://gateway.spraay.app/api/v1/batch/execute

x402 fee: $0.02 USDC per call (paid automatically via the x402 payment protocol on Base).

Request

{
  "token": "USDC",
  "recipients": [
    { "address": "0xAlice", "amount": "100.00" },
    { "address": "0xBob", "amount": "50.00" },
    { "address": "0xCarol", "amount": "25.00" }
  ]
}

• token — token symbol (e.g., "USDC", "ETH"). Omit or use "ETH" for native
• recipients — array of { address, amount } objects
• Amounts are in human-readable units (not wei/lamports)
• Returns unsigned transaction data for the user's wallet to sign

Response

The gateway returns transaction data ready for signing. The 0.3% protocol fee is already factored into the transaction.

Integration

x402-client (recommended)

import { createClient } from "x402-client";

const client = createClient({
  baseUrl: "https://gateway.spraay.app",
  privateKey: process.env.EVM_PRIVATE_KEY
});

const tx = await client.post("/api/v1/batch/execute", {
  token: "USDC",
  recipients: [
    { address: "0xAlice", amount: "100.00" },
    { address: "0xBob", amount: "50.00" }
  ]
});

Spraay dApp (no code)

Users can batch-send directly at spraay.app — connect wallet, add recipients or upload CSV, and spray.

MCP server

The @plagtech/spraay-x402-mcp server on Smithery wraps all gateway endpoints for MCP-compatible agents.

npx @smithery/cli install @plagtech/spraay-x402-mcp

Important notes

• The gateway returns unsigned transaction data — the user's wallet must sign and broadcast
• Always confirm recipients, amounts, and total cost with the user before signing
• The 0.3% protocol fee is deducted from the batch amount automatically
• For non-EVM chains, chain-specific transaction formats are returned (PSBT for Bitcoin, XDR for Stellar, etc.)
• The x402 gateway is optimized for Base and Solana USDC

Resources

• App: https://spraay.app
• Docs: https://docs.spraay.app
• Gateway: https://gateway.spraay.app
• GitHub: https://github.com/plagtech
• MCP: https://smithery.ai/server/@plagtech/spraay-x402-mcp