nuez.transfer

Initiates a transfer from your nuez wallet to a CVU, CBU, or alias.

Requires scope: transfer:write

Parameters

Parameter	Type	Required	Description
`amount`	`number`	✓	Amount in ARS (Argentine pesos). Minimum: `1`.
`destination`	`string`	✓	CVU (22 digits), CBU (22 digits), or alias (e.g. `proveedor.empresa`)
`description`	`string`		Text attached to the transfer. Visible to the recipient. Max 140 chars.
`idempotency_key`	`string`		Unique string to prevent duplicate transfers. If omitted, nuez generates one. Recommended for automated agents.

Return value

On success (below threshold or after approval):

{
  "id": "txn_01HXYZ...",
  "status": "completed",
  "amount": 5000,
  "destination": "proveedor.empresa",
  "description": "Invoice #42",
  "completed_at": "2026-04-23T14:32:01Z"
}

On approval required (amount ≥ threshold):

{
  "id": "txn_01HXYZ...",
  "status": "approved",
  "amount": 50000,
  "destination": "proveedor.empresa",
  "description": "Monthly retainer",
  "approved_at": "2026-04-23T14:33:15Z",
  "completed_at": "2026-04-23T14:33:16Z"
}

Error responses

Error	When
`insufficient_balance`	Wallet balance is less than `amount`
`rejected`	Owner rejected the WhatsApp approval
`expired`	Approval window timed out (5 minutes)
`invalid_destination`	CVU/CBU/alias could not be resolved
`scope_denied`	Key does not have `transfer:write`
`allowlist_violation`	Destination is not in the key’s allowlist

Example

Ask Claude: "Transfer $2500 to alias pago.servicios with description 'Monthly invoice'"

Claude calls:

{
  "tool": "nuez.transfer",
  "arguments": {
    "amount": 2500,
    "destination": "pago.servicios",
    "description": "Monthly invoice",
    "idempotency_key": "invoice-2026-04"
  }
}