# Madhouse Wallet Create Money Transfer (v2)

> Madhouse Wallet Create Money Transfer (v2) is a paid API for AI agents from try.madhousewallet.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Creates a cross-border money transfer from a locked quote and recipient, returning a Base USDC deposit address and exact funding amount

## Facts

- Endpoint: POST https://try.madhousewallet.com/api/public/transfer
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/try-madhousewallet-com-81412e0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vsba0Y4DDhP1BFxWBuV_Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability try-madhousewallet-com-81412e0d -d '<json body>'
```

Example prompt: I have a locked quote ID 'q_abc123' and recipient ID 'r_xyz789' — create the money transfer now and give me the Base USDC deposit address and exact amount I need to send to fund it.

## When to prefer this

Use this endpoint after you have obtained a locked quote (via the /quote endpoint) and created a recipient (via the /recipient endpoint) and are ready to execute the transfer. This is the correct step to get the on-chain deposit address for USDC funding on Base. Do not use this for getting quotes, checking status, or confirming an already-funded transfer.

## Known failure modes

- Quote expired or not locked — transfer creation rejected
- Recipient ID not found or invalid — 404 error
- KYC or sanctions check failure on funding wallet — transfer blocked upstream
- Quote and recipient currency mismatch — validation error
- Duplicate transfer creation from same quote — conflict error
- Insufficient metadata on recipient — validation failure

## How this service works

Convert USDC to 45+ local currencies and receive funds directly to your bank account. Fast, secure crypto offramp powered by Madhouse Wallet.

## Output

Returns a transfer ID uniquely identifying the transfer, a Base network USDC deposit_address to send funds to, and the exact USDC amount required to fund the transfer. After sending funds on-chain, the confirm-transfer endpoint must be called with the transaction hash to complete the flow.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "amount": {
   "type": "number",
   "description": "USD source amount; must match the quote. Greater than 0, at most 1000000."
  },
  "quote_id": {
   "type": "string",
   "description": "quoteId from /api/public/quote (UUID)."
  },
  "recipientId": {
   "type": "number",
   "description": "Recipient id from /api/public/recipients."
  },
  "source_token": {
   "type": "string",
   "description": "Funding token, e.g. usdc."
  },
  "customer_uuid": {
   "type": "string",
   "description": "Customer UUID identifying the sender."
  },
  "customer_email": {
   "type": "string",
   "description": "Sender email address."
  },
  "source_network": {
   "type": "string",
   "description": "Funding network, e.g. base."
  },
  "wallet_address": {
   "type": "string",
   "description": "Funding wallet address (0x EVM or Solana base58)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "amount": 100,
  "currency": "NGN",
  "transfer_id": "6650f1a2b3c4d5e6f7a8b9c0",
  "instructions": {
   "note": "Send exactly 100 USDC on Base to the deposit address.",
   "send_token": "usdc",
   "send_amount": 100,
   "send_network": "base",
   "deposit_address": "0x1234567890abcdef1234567890abcdef12345678"
  },
  "source_token": "usdc",
  "source_network": "base",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "deposit_address": "0x1234567890abcdef1234567890abcdef12345678"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/try-madhousewallet-com-81412e0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from try.madhousewallet.com](https://www.zero.xyz/host/try.madhousewallet.com/llms.txt)