# MW Payouts API

## Docs

- [API reference](https://developer.madhousewallet.com/api-reference/introduction.md): Endpoints, parameters, and response schemas for the MW Payouts API.
- [Confirm a v2 transfer](https://developer.madhousewallet.com/api-reference/payouts/confirm-a-v2-transfer.md): After sending USDC on-chain to the `deposit_address` returned by `POST /api/payouts/transfer/v2`, call this endpoint with the `transfer_id` and the on-chain transaction hash (`tx_hash`). The platform will use the hash to match the incoming deposit to your transfer and automatically initiate the fiat…
- [Create a transfer](https://developer.madhousewallet.com/api-reference/payouts/create-a-transfer.md): Creates a payout transfer and returns a unique deposit address on the network specified by `source_network`. Send USDC from `wallet_address` to that address — MW handles the rest of the conversion and delivery pipeline automatically.
- [Create a v2 transfer](https://developer.madhousewallet.com/api-reference/payouts/create-a-v2-transfer.md): Creates a v2 payout transfer and returns a hardcoded deposit address for the requested `source_token`/`source_network` combination. Unlike v1, the deposit address is fixed — no provider API call is made at initiation time.
- [Get a quote](https://developer.madhousewallet.com/api-reference/payouts/get-a-quote.md): Returns a live exchange-rate quote for a USD → foreign currency payout, including fees and estimated delivery time.
- [Get a transfer](https://developer.madhousewallet.com/api-reference/payouts/get-a-transfer.md): Returns the current status and details of a payout transfer by its `transfer_id` (the value returned by `POST /api/payouts/transfer`).
- [Get amount limits](https://developer.madhousewallet.com/api-reference/payouts/get-amount-limits.md): Returns the minimum and maximum USD amounts that your account is permitted to submit to `GET /api/payouts/quote` and `POST /api/payouts/transfer`.
- [Get platform fee](https://developer.madhousewallet.com/api-reference/payouts/get-platform-fee.md): Returns the MW platform fee for a given USD amount based on your account's fee configuration. This is a lightweight call with no external API dependencies — suitable for real-time display as users type amounts.
- [List deposit options](https://developer.madhousewallet.com/api-reference/payouts/list-deposit-options.md): Returns the list of source token/network combinations accepted for deposits. Use the `token` and `network` values as `source_token` and `source_network` in `POST /api/payouts/transfer`.
- [Create a recipient](https://developer.madhousewallet.com/api-reference/recipients/create-a-recipient.md): Creates a new payout recipient linked to your account. Use `GET /api/payouts/account-requirements` first to determine the correct `type` and `details` fields for the target currency.
- [Delete a recipient](https://developer.madhousewallet.com/api-reference/recipients/delete-a-recipient.md): Deactivates a payout recipient. The recipient must belong to your account. Deleted recipients cannot be used in future transfers.
- [Get a recipient](https://developer.madhousewallet.com/api-reference/recipients/get-a-recipient.md): Returns a single recipient by ID. The recipient must belong to your account.
- [Get account requirements](https://developer.madhousewallet.com/api-reference/recipients/get-account-requirements.md): Returns the list of account types and their required fields for a given target currency. Call this **before** creating a recipient to know which fields to collect.
- [List recipients](https://developer.madhousewallet.com/api-reference/recipients/list-recipients.md): Returns all active payout recipients belonging to your account.
- [Refresh account requirements](https://developer.madhousewallet.com/api-reference/recipients/refresh-account-requirements.md): When a field has `refreshRequirementsOnChange: true`, POST the current form state to this endpoint to receive an updated field list. For example, changing `legalType` from `PRIVATE` to `BUSINESS` may reveal a company name field.
- [Update a recipient](https://developer.madhousewallet.com/api-reference/recipients/update-a-recipient.md): Updates the `accountHolderName` and/or `details` of an existing recipient. The recipient must belong to your account. Provide at least one field to update.
- [Authentication](https://developer.madhousewallet.com/authentication.md): Authenticate requests to the MW Payouts API with a Bearer API key.
- [Changelog](https://developer.madhousewallet.com/changelog.md): Notable changes to the MW Payouts API.
- [Compliance](https://developer.madhousewallet.com/concepts/compliance.md): How wallet verification, wallet screening, and sanctions screening protect payouts.
- [Quotes and fees](https://developer.madhousewallet.com/concepts/quotes-and-fees.md): How exchange-rate quotes, platform fees, and settlement fees are calculated.
- [Recipients and account requirements](https://developer.madhousewallet.com/concepts/recipients.md): Collect the right bank details for each currency and manage payout recipients.
- [Supported currencies, tokens, and networks](https://developer.madhousewallet.com/concepts/supported-currencies.md): Source tokens and networks you can deposit, and the fiat currencies you can pay out.
- [Transfer lifecycle](https://developer.madhousewallet.com/concepts/transfer-lifecycle.md): Every status a payout transfer moves through, from creation to delivery.
- [v1 vs v2 transfers](https://developer.madhousewallet.com/concepts/v1-vs-v2.md): Compare the two transfer pipelines and choose the right one for your integration.
- [Introduction](https://developer.madhousewallet.com/index.md): Programmatically convert USDC and USDT into fiat payouts to bank accounts worldwide.
- [MCP server](https://developer.madhousewallet.com/mcp-server.md): Connect an AI agent to the MW Payouts API through the hosted Model Context Protocol server.
- [Quickstart](https://developer.madhousewallet.com/quickstart.md): Make your first USDC-to-fiat payout end to end.
- [Rate limits and errors](https://developer.madhousewallet.com/rate-limits-and-errors.md): Per-endpoint rate limits and the API's error model.

## OpenAPI Specs

- [openapi](https://developer.madhousewallet.com/openapi.json)

## Optional

- [Dashboard](https://business.madhousewallet.com/developers)
- [Support](mailto:support@madhousewallet.com)