Payout API

POST /payout/* (Node.js Service)

Batch USDC transfer endpoints.

Preview Batch Transfer

POST /payout/preview

Preview fees and totals before submitting.

Request

{
  "wallet": "0xSenderWallet...",
  "chain": "eip155:8453",
  "token": "USDC",
  "recipients": [
    { "address": "0xRecipient1...", "amount": 100 },
    { "address": "0xRecipient2...", "amount": 50 },
    { "address": "0xRecipient3...", "amount": 200 }
  ]
}

recipients can be a JSON array or a JSON string.

Response

{
  "wallet": "0xSenderWallet...",
  "chain": "eip155:8453",
  "token": "USDC",
  "recipientCount": 3,
  "totalAmount": 350,
  "fee": 1.75,
  "estimatedGas": "~0.001 ETH"
}

Submit Batch Transfer

POST /payout/batch

Request

Same format as preview.

Response

{
  "status": "pending",
  "wallet": "0xSenderWallet...",
  "chain": "eip155:8453",
  "token": "USDC",
  "recipientCount": 3,
  "totalAmount": 350,
  "fee": 1.75,
  "message": "Batch payout submitted (stub — chain integration pending)"
}

Field	Description
`fee`	Fee = totalAmount × 0.5%
`status`	Currently `pending` (on-chain submission feature in development)