Skip to main content
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:
  • A name to identify it.
  • Fee rates for on-ramp and off-ramp transactions.
  • A wallet address where collected fees are sent.
You can create multiple partner fees for different use cases and customers.

​
Fee types

Two fee types, configured independently for on-ramp and off-ramp: You can combine both. For example, charge 50 bps plus a $0.50 flat fee 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:

​
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)
  • Stellar wallets
You can use a Lumx-generated wallet by creating a customer from your entity, or use your own treasury wallet.
Test fee collection in sandbox before going live.

Transactions

Where partner fees are applied and collected.

Exchange Rates

Locked rates can include the fee in the quote.