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.

The DAMM v2 rate limiter is a base fee mode that increases the effective fee as buy size increases. It is designed for launch pools where oversized early buys can distort distribution or create a poor trading experience. Instead of charging every buy the same fee, the rate limiter behaves like a fee slope.

​
How It Works

The pool defines a reference amount. Buys up to that amount pay the cliff fee. As the token B input amount grows beyond the reference amount, DAMM v2 applies higher fee tiers until the configured maximum fee is reached. In product terms, a small buy may pay the base fee, while a much larger buy pays a higher average fee.

​
Key Settings

SettingProduct Meaning
Cliff fee numeratorStarting fee for the first reference amount
Reference amountTrade size unit used for the fee slope
Fee increment bpsHow much the fee increases per step
Max fee bpsHighest fee the limiter can charge
Max limiter durationHow long the limiter is active after launch

​
Requirements

Rate limiter mode has specific product constraints:
  • It applies only when the trade direction is B-to-A.
  • It is valid only with OnlyB collect fee mode.
  • It starts at the activation point and lasts only through the configured limiter duration.
  • DAMM v2 validates that rate-limited swaps are not bundled as multiple swaps against the same pool in one transaction.
  • The limiter duration is capped at 12 hours: 43,200 seconds for timestamp activation or 108,000 slots for slot activation.
If reference_amount, max_limiter_duration, max_fee_bps, and fee_increment_bps are all zero, the rate limiter acts as a fixed cliff-fee mode.
Rate limiter is mutually exclusive with the time scheduler and market cap scheduler base fee modes. A DAMM v2 pool chooses one base fee mode.

​
Why Use It

Discourage Oversized Buys

Larger launch buys can pay progressively higher fees.

Protect Early Distribution

The fee slope helps reduce the advantage of very large first movers.

Quote Token Fee Capture

Fees are aligned with quote-token collection, which is common for launches.

Short Launch Window

The limiter is meant for early trading, not permanent pool behavior.

​
When To Choose Rate Limiter

Use the rate limiter when the main risk is not just early timing, but early trade size. It is best for launches that want to allow public trading while making very large buys increasingly expensive during the first launch window.