A partner fee is an extra charge you add on top of a transaction to earn revenue. You define the fee structure, Lumx collects it from your customers and shares it with you. Each configuration has:Documentation Index
Fetch the complete documentation index at: https://docs.lumx.io/llms.txt
Use this file to discover all available pages before exploring further.
- A name to identify it.
- Fee rates for on-ramp and off-ramp transactions.
- A wallet address where collected fees are sent.
Fee types
Two fee types, configured independently for on-ramp and off-ramp:| Type | Description | Example |
|---|---|---|
| Rate | Percentage of the transaction amount, in basis points (bps). | 75 bps = 0.75% |
| Flat | Fixed amount per transaction, in dollars. | $1.00 per transaction |
Default fee
You can mark one partner fee as default (isDefault: true). When a transaction or exchange rate request doesn’t include a partnerFeeId, Lumx applies the default fee.
Useful when you want consistent pricing across transactions without specifying the fee each time.
Configuring partner fees
Create and manage partner fees in the Dashboard or through the API.You need to be a project admin or owner to create partner fees.
When fees are applied
How you apply a partner fee depends on which exchange rate type you use:| Rate type | When to include partnerFeeId |
|---|---|
| Locked rate | When requesting the exchange rate. The fee becomes part of the locked quote. |
| Floating rate | When creating the transaction, or omit it to use your default fee. |
Fee destination
Collected fees are sent to the wallet address you specify. Supported networks:- EVM-compatible wallets (Ethereum, Polygon, Base, etc.)
- TVM-compatible wallets (Tron)
Related resources
Transactions
Where partner fees are applied and collected.
Exchange Rates
Locked rates can include the fee in the quote.