Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.meteora.ag/llms.txt

Use this file to discover all available pages before exploring further.

DAMM v2 time scheduler fees let a pool use a fixed base fee or start with a higher launch fee and reduce that fee over time. This is useful when a launch needs stronger early protection, but should gradually move toward normal trading conditions. Time scheduler fees are based on a clock: after trading activates, DAMM v2 counts configured periods and adjusts the fee as each period passes.

​
How It Works

A time scheduler uses four core settings:
SettingProduct Meaning
Cliff fee numeratorStarting fee when the pool opens
Number of periodsHow many fee reductions happen
Period frequencyHow long each period lasts
Reduction factorHow much the fee changes each period
DAMM v2 supports two time scheduler curves: linear and exponential.

​
Linear Time Scheduler

The linear time scheduler decreases the fee numerator by the same fixed amount each period. Fee Numerator=Cliff Fee Numerator−(Passed Periods×Reduction Factor)\text{Fee Numerator} = \text{Cliff Fee Numerator} - (\text{Passed Periods} \times \text{Reduction Factor}) In product terms, the fee walks down a staircase. Every step is the same size, so teams can explain exactly when the fee will drop and by how much. Use linear time scheduling when you want a simple, predictable launch schedule such as “fees decrease by the same amount every few minutes until the launch window ends.”

​
Exponential Time Scheduler

The exponential time scheduler reduces the fee by applying the reduction factor each period. Fee Numerator=Cliff Fee Numerator×(1−Reduction Factor10,000)Passed Periods\text{Fee Numerator} = \text{Cliff Fee Numerator} \times \left(1 - \frac{\text{Reduction Factor}}{10{,}000}\right)^{\text{Passed Periods}} In product terms, the fee drops faster early, then slows as it approaches the final fee. The exact on-chain calculation uses integer math.

​
Fixed Fee Configuration

A time scheduler can also behave as a fixed fee. If period_frequency, number_of_period, and reduction_factor are all zero, the program returns the cliff fee numerator for every swap.
If any of those three scheduler fields is non-zero, all three must be non-zero. Mixed zero/non-zero scheduler settings are invalid.

​
Pre-Activation Behavior

If the current slot or timestamp is before the pool activation point, the time scheduler uses the final period. This path is used for pre-activation alpha-vault buying, not normal public trading.

​
Why Use Time Scheduler Fees

Launch Protection

Early trades can face higher fees when launch sniping risk is often highest.

Predictable Decay

Fees move according to a configured time schedule rather than manual updates.

Flexible Curve Choice

Linear decay is easier to communicate, while exponential decay drops faster at the start.

Launchpad Friendly

Time schedulers work well for repeatable launch templates and public launch windows.

​
Linear vs Exponential

CurveBest ForFee Behavior
LinearSimple, transparent schedulesFee numerator decreases by a fixed amount each period
ExponentialStrong early protection with faster early reliefFee numerator decreases by a percentage-style factor each period

​
When To Choose It

Use a time scheduler when the launch plan is time-based. If fees should come down after a fixed number of slots or seconds, time scheduling is the clearest choice. Use Market Cap Scheduler Fees instead when fees should decrease only as the pool price grows.