Trading Fees Calculation
DBC Pools earn a trading fee from traders when they perform a swap. The fees can be collected in two ways:
- Quote only
- Quote + Base
Total Trading Fee
The total swap fee () will have two components:
- A base fee ()
- A variable fee ()
The total swap fee is calculated as:
The variable fee () is a function of real-time price volatility. The fee rate will be applied to the swap amount in each liquidity bin and distributed proportionally to the LPs in that bin.
LPs can claim these fees whenever they are available.
Base Fee
The base fee of a pool can be configured by the pool creator in the following ways:
- Fixed Base Fee: A fixed fee that is applied to the swap amount.
- Fee Scheduler: A fee decay mechanism that decays the fee from a high starting fee to an ending fixed base fee over a period of time. The ending fee will be the fixed base fee of the pool after the fee scheduler is finished.
- Rate Limiter: A fee slope mechanism that starts at a fixed base fee and increases the fee depending on the buy amount. The fee after the rate limiter is finished will be the fixed base fee of the pool.
Fixed Base Fee
Fixed base fee is a fixed fee that is applied to the swap amount. The fee can range from 0.01% to 50%. It is specified in the config key used for the pool creation.
Fee Scheduler
Fee scheduler is a fee decay mechanism that decays the fee from starting fee to an ending base fee over a period of time.
The fee math calculation for the scheduler can be found here.
Rate Limiter
Rate limiter is a fee slope mechanism that starts at a fixed base fee and increases the fee depending on the buy amount
The fee math calculation for the rate limiter can be found here.
Dynamic Fee (Variable Fee)
The variable fee is the core of the dynamic fee mechanism. It increases with market volatility.
where:
- Volatility Accumulator (): A measure of recent price volatility
- Bin Step (): A parameter that defines the price granularity for measuring volatility
- Variable Fee Control (): A parameter to control the magnitude of the variable fee
Volatility Accumulator
The Volatility Accumulator tracks price movements. It’s updated with every swap.
where:
- Max Volatility Accumulator (): A cap on the volatility measure to prevent fees from becoming excessively high
- Volatility Reference (): A decayed value of the volatility accumulator
- Price Change (): The price change since the last reference update, measured in “bins”
Price Change
The price change is calculated based on the change in the square root of the price.
where is current price and is reference price.
Volatility Decay
To ensure that the dynamic fee reflects recent volatility, the Volatility Reference decays over time.
The decay mechanism is based on the time elapsed since the last significant trade:
- If elapsed time < filter period: No change. This ignores very high-frequency trades.
- If filter period ≤ elapsed time < decay period: The volatility reference is reduced.
- If elapsed time ≥ decay period: The volatility reference is reset to 0. This happens if there are no significant trades for an extended period.
Max Dynamic Fee on DBC for Typescript SDK Build Curve functions
If you use any of the buildCurve
helper functions in the DBC Typescript SDK, the max dynamic fee on DBC when toggled true
is less than or equals to 20% of the Base Fee.
Example:
- Base Fee = 1%
- Dynamic Fee = 0.2%
- Total Trading/LP Fee = 1.2%