# Fees

Madhouse Wallet pricing is designed to be predictable. All fees are disclosed in the quote response before a transfer is submitted.

***

## Fee Structure

| Fee                 | Amount                                                            |
| ------------------- | ----------------------------------------------------------------- |
| **Transaction fee** | $2 for transfers under $1,000 · $3 for transfers $1,000 and above |
| **Platform fee**    | 0.5% of transfer amount                                           |
| **FX spread**       | Mid-market rate (0.3% typical)                                    |
| **Settlement fee**  | Variable — typically under 1% for transfers above $500 USDC       |

All fees are shown in the `GET /api/payouts/quote` response before committing to a transfer.

***

## How Fees Are Applied

1. The fixed **transaction fee** is deducted from the USD amount first
2. The remaining amount is converted at the **mid-market FX rate**
3. The **platform fee** and **settlement fee** are applied during routing

The `quote` response breaks this down:

```json
{
  "txFee": 2,
  "netUsdAmount": 198,
  "eurAmount": 183.12,
  "quote": {
    "paymentOptions": [
      {
        "targetAmount": 28450.00,
        "fee": { "total": 1.20, "currency": "EUR" }
      }
    ]
  }
}
```

***

## Volume Pricing

Larger transactions carry smaller effective fees as a percentage of the total. Enterprise partners can negotiate custom fee structures.

***

## Enterprise & Partner Pricing

Volume discounts and revenue share programs are available. Contact <support@madhousewallet.com> to discuss pricing tiers for high-volume integrations.

***

## Quote Validity

FX quotes are locked for **5 minutes**. The rate shown at quote time is the rate applied to the transfer — there are no surprise adjustments after submission.

<figure><img src="https://3012496985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Z7mycTyf5CtK8GXQGVY%2Fuploads%2Fgit-blob-5223718e8c41773bcba5b5dd8d6b77f9784de595%2Fhuey-and-dewey-v0-czlzbmcm8gub1.webp?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.madhousewallet.com/fees.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.