Agent payments x402

Agent Payments

Move money on-chain from an agent without writing contract code. This skill wraps the Spraay x402 Gateway (gateway.spraay.app) — batch disbursement across Base and additional EVM chains, plus payroll, invoicing, and escrow on Base. Every call is paid per-use with the x402 protocol, so there are no API keys, accounts, or subscriptions.

The batch and payroll endpoints implement Batch Payments for Agents (BPA) 1.0, an open settlement spec: https://docs.spraay.app/bpa/1.0/

When to use this skill

Use it when the task involves sending or holding value:

• Pay many wallets at once (airdrops, rewards, contributor payouts, refunds)
• Run recurring or one-off stablecoin payroll
• Create an invoice that auto-settles to a wallet when paid
• Lock funds in escrow and release them on a condition

Do not use it for read-only DeFi data (prices, swaps, wallet analytics) — that's the defi-intelligence skill in this repo.

Setup

Payment is automatic via the x402 client. You need a wallet funded with USDC on Base.

npm install x402-client
export EVM_PRIVATE_KEY=0x...   # wallet holding USDC on Base

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

When you hit an endpoint without payment, the gateway returns HTTP 402 with the exact price; the client signs the USDC authorization and retries automatically.

Endpoints

Batch payments (BPA 1.0)

Method	Path	Price	Description
POST	/api/v1/batch/execute	$0.02	Batch-send native or ERC-20 to many recipients in one tx. Chains: Base, Ethereum, Arbitrum, Polygon, BNB, Avalanche, Unichain, Plasma, BOB.
POST	/api/v1/batch/estimate	$0.001	Estimate gas + fees before executing a batch.

Payroll

Method	Path	Price	Description
POST	/api/v1/payroll/execute	$0.10	Run a payroll batch — stablecoin payments to a roster.
POST	/api/v1/payroll/estimate	$0.003	Estimate payroll batch cost before executing.
GET	/api/v1/payroll/tokens	$0.002	Supported payroll tokens (USDC, USDT, DAI, EURC, ...).

Invoicing

Method	Path	Price	Description
POST	/api/v1/invoice/create	$0.05	Create an x402 payment-gated invoice; shareable link, auto-settles to wallet.
GET	/api/v1/invoice/list	$0.01	List your invoices with status and payment history.
GET	/api/v1/invoice/:id	$0.001	Fetch invoice details and payment status.

Escrow

Method	Path	Price	Description
POST	/api/v1/escrow/create	$0.10	Create an on-chain escrow between two parties.
POST	/api/v1/escrow/fund	$0.02	Fund an existing escrow with USDC or a supported token.
POST	/api/v1/escrow/release	$0.08	Release escrow funds after conditions are met.
POST	/api/v1/escrow/cancel	$0.02	Cancel an escrow before funding or by mutual agreement.
GET	/api/v1/escrow/list	$0.02	List active and historical escrows.
GET	/api/v1/escrow/:id	$0.001	Fetch escrow details and status.

Examples

Batch-send USDC to 50 wallets on Base:

const tx = await client.post("/api/v1/batch/execute", {
  chain: "base",
  token: "USDC",
  recipients: [
    { address: "0xabc...", amount: "10.00" },
    { address: "0xdef...", amount: "25.50" },
    // ...
  ],
});

Estimate first, then run payroll:

const quote = await client.post("/api/v1/payroll/estimate", { token: "USDC", roster });
const run = await client.post("/api/v1/payroll/execute", { token: "USDC", roster });

Create a payment-gated invoice:

const invoice = await client.post("/api/v1/invoice/create", {
  amount: "250.00", token: "USDC", memo: "Design work — March",
});
// invoice.url is a shareable x402 link that settles to your wallet

Notes

• Settlement is USDC on Base by default. Multi-chain support applies to batch payments only (the chains listed in the batch row above); payroll, invoicing, and escrow settle on Base.
• Spraay batch contract on Base: 0x1646452F98E36A3c9Cfc3eDD8868221E207B5eEC
• Full catalog: https://docs.spraay.app · Live traffic: https://live.spraay.app