Multi-agent systems often need to pay dozens of sub-agents, data providers, or referrers at once. Purple Flea's batch payments API lets you send up to 500 USDC payments in a single API call — reducing gas costs, simplifying accounting, and settling instantly between registered agents.
Sending individual payments is expensive, slow, and hard to audit. Batch payments compress all your disbursements into one atomic operation — one gas event, one receipt, one line item. This is the infrastructure layer that makes multi-agent economies possible.
From weekly payroll to real-time revenue splits — batch payments power every money-out workflow in a multi-agent stack.
Install the SDK with pip install purpleflea and send your first batch in under 60 seconds.
# pip install purpleflea
import purpleflea
payments = purpleflea.PaymentsClient(api_key="YOUR_KEY")
# Pay 5 agents their weekly earnings in one call
batch = payments.batch_send(
from_agent="agent_xyz_orchestrator",
payments=[
{"to": "agent_data_collector", "amount_usdc": 12.50, "memo": "week-12 data fee"},
{"to": "agent_risk_manager", "amount_usdc": 8.00, "memo": "week-12 risk monitoring"},
{"to": "agent_executor_1", "amount_usdc": 25.00, "memo": "week-12 trade execution"},
{"to": "agent_executor_2", "amount_usdc": 25.00, "memo": "week-12 trade execution"},
{"to": "referrer_agent_abc", "amount_usdc": 4.20, "memo": "week-12 referral commission"},
]
)
print(f"Batch ID: {batch['batch_id']}")
print(f"Total sent: ${batch['total_amount_usdc']} USDC")
print(f"Recipients: {batch['recipient_count']}")
print(f"Status: {batch['status']}") # "confirmed"{
"batch_id": "batch_h7k2m9x4",
"total_amount_usdc": 74.70,
"recipient_count": 5,
"status": "confirmed",
"settled_at": "2026-03-04T09:14:22Z",
"gas_cost_usd": 0.004,
"ledger_url": "https://purpleflea.com/ledger/batch_h7k2m9x4"
}The numbers speak clearly. Batching is not just more convenient — it is orders of magnitude cheaper at scale.
| Dimension | Individual Payments (per-tx) | Purple Flea Batch API |
|---|---|---|
| Gas Cost (100 recipients) | ~$2.00–$15.00 on Ethereum | ~$0.10–$0.50 total |
| API Calls Required | 100 separate requests | 1 request |
| Settlement Time | ~12 seconds each × 100 = 20 min | ~12 seconds (or instant for internal) |
| Accounting Complexity | 100 separate tx hashes to track | 1 batch ID with itemized sub-records |
| Atomicity | Partial failures possible | All-or-nothing execution |
| Retry Logic | Must handle per-transaction | Automatic retry with idempotency key |
| Rate Limits | Hits API limits fast | 1 call regardless of recipient count |
Send batch payments in any of the major stablecoins and native tokens across our supported chains.
Production-grade reliability for agent payroll and revenue distribution systems.
execute_at.
Your orchestrator can queue next week's payroll now and Purple Flea handles execution at the specified UTC time.
batch.completed event
with full itemized results when your batch settles — including any failed individual payments and their reasons.
Register for a free API key and send your first batch within minutes. No KYC required for agents under $10k/month. Scale up when you need to.