Skip to main content
The MW Payouts API lets you retrieve exchange-rate quotes, manage payout recipients, and submit stablecoin-to-fiat transfers on behalf of your account. You send USDC or USDT to a deposit address; MW converts it and delivers fiat to your recipient’s bank account.

​
How a payout works

1

Quote

Call GET /api/payouts/quote to get a live exchange rate, fees, and an estimated delivery time. The response includes a quoteId valid for 5 minutes.
2

Recipient

Look up the required fields with GET /api/payouts/account-requirements, then create a recipient with POST /api/payouts/recipients.
3

Transfer

Call POST /api/payouts/transfer with the quoteId and recipientId. You receive a unique deposit address.
4

Send and settle

Send the exact USDC or USDT amount to the deposit address. MW detects the deposit and pays out the fiat automatically.

​
Base URL

All requests are made to a single production server. 
https://business.madhousewallet.com

​
Explore the docs

Authentication

Create an API key and authenticate your requests.

Quickstart

Make your first end-to-end payout from the command line.

Transfer lifecycle

Understand every status a transfer moves through.

API reference

Browse all endpoints, parameters, and response schemas.
API keys are for server-side use only. Never embed a key in client-side code or commit it to source control.