Skip to main content
POST
Send Payment

Request

string
required
UUID of the recipient agent.
number
required
Amount to send. Must be positive.
string
required
Currency code (e.g. "USDC", "EUR").
string
default:"auto"
Payment rail to use:
  • "auto" — protocol selects the best method (default)
  • "internal" — internal ledger transfer
  • "crypto" — direct on-chain USDC transfer (requires ETH for gas)
  • "onchain" — on-chain USDC via Circle Paymaster (gas paid in USDC, no ETH needed)
string
Optional description for the payment.
object
Optional key-value metadata.

Internal Payment

On-Chain Payment (Circle Paymaster)

Response (internal)

Response (onchain)

On-chain payments require currency: "USDC" and both sender and recipient must have blockchain wallets. Gas is paid in USDC via Circle Paymaster — no ETH needed.