> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bags.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# Customize Token Fees

> Learn how to configure different fee structures for your token launch using Bags config types

When launching a token via the Bags API, you can customize the fee structure by passing the optional `bagsConfigType` parameter to the [Create Fee Share Config](https://docs.bags.fm/api-reference/create-fee-share-configuration.md) endpoint. This controls how much in trading fees the token takes at different stages of its lifecycle.

The fee-mode tables and SOL thresholds below describe **SOL-quoted launches**. For a non-WSOL quote, use [Custom Quote Configurations](#custom-quote-configurations): the selected type retains its trading fee rates but uses its configured quote threshold and zero compounding.

## Fee Distribution

The tables below show the **platform pool**, **gross claimers pool**, and **compounding** allocation before partner and deployer deductions. The columns labeled **Protocol** and **Creator** refer to those first two pools; **Creator** is not the final payout to the configured fee recipients.

Newly created SOL fee-share v2 configs give the separate [deployer](https://docs.bags.fm/how-to-guides/deployer-fees.md) 25% of the gross claimers pool; normal recipients divide the remaining 75%. A partner share, when present, is deducted from the platform pool and does not reduce the claimers pool. With no compounding, a 2% trading fee therefore gives 1% to the platform, 0.25% to the deployer, and 0.75% to the configured recipients. See [Deployer Fees](https://docs.bags.fm/how-to-guides/deployer-fees.md) for the calculation and the dedicated deployer balance/claim endpoints. Creator balance and claim endpoints cover the normal recipient portion only.

The gross split depends on whether fee compounding is enabled:

| Setup | Protocol | Creator | Compounding |
| - | - | - | - |
| No compounding | 50% of fee | 50% of fee | — |
| 25% compounding | 37.5% of fee | 37.5% of fee | 25% of fee |
| 50% compounding | 25% of fee | 25% of fee | 50% of fee |

For example, a 2% fee without compounding gives 1% to the protocol and 1% to the gross claimers pool. A 2% fee with 25% compounding gives 0.5% to compounding, 0.75% to the protocol, and 0.75% to the gross claimers pool. A 1% fee with 50% compounding gives 0.5% to compounding, 0.25% to the protocol, and 0.25% to the gross claimers pool.

## Fee Modes

There are seven SOL fee modes. If you don't specify a `bagsConfigType`, the **Default** mode is used.

### Default

**Config ID:** `fa29606e-5e48-4c37-827f-4b03d58ee23d`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 2% | 1% | 1% | — |
| Post-migration | 2% | 0.75% | 0.75% | 0.5% |

The standard fee structure. A flat 2% fee on all trades. Pre-migration, the fee is split equally between the platform and gross claimers pools. Post-migration, 25% of fees are compounded back into the pool's liquidity, with the remainder split equally between the platform and gross claimers pools. This is the simplest option and works well for most token launches.

### Low Float

**Config ID:** `ba28db46-ea6f-4452-8218-5587f6aca0a1`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 2% | 1% | 1% | — |
| Post-migration | 2% → 0.5% by market cap (see below) | 37.5% of fee | 37.5% of fee | 25% of fee |

Like the **Default** mode, 25% of post-migration fees are compounded back into the pool's liquidity and the remainder is split equally between the platform and gross claimers pools. This mode adds two things on top: **96% of the token supply is locked**, and a **market-cap-based fee post-migration** (starting at 2% and decaying to a 0.5% floor).

**Post-migration market-cap fee:** the 2% base fee only holds during the bonding-curve phase. Once the token graduates (raises 80 SOL and migrates to the real DAMM v2 pool), the trading fee no longer stays flat — it starts at 2% and shrinks as the token's market cap grows, down to a **0.5% floor**. The bigger and more successful the token gets, the cheaper it is to trade. The decay is exponential (it drops faster early, then eases toward the floor) and bottoms out once the market cap is roughly **25x** its value at graduation:

```text theme={null}
   1x MC (just graduated): 2.00%
  ~2x                    : ~1.45%
  ~5x                    : ~1.00%
  ~9x                    : ~0.80%
 ~15x                    : ~0.63%
 ~25x and beyond         : 0.50%   <- floor, stays here
```

As with the Default mode, 25% of each post-migration fee is compounded back into the pool's liquidity and the remaining 75% is split equally between the platform and gross claimers pools. Existing configs keep the threshold and curve with which they were created.

### Drop Mode

**Config ID:** `810faadb-030b-47de-a68b-7211c1cbbee3`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 2% | 1% | 1% | — |
| Post-migration | 2% | 0.75% | 0.75% | 0.5% |

Identical fee economics to the **Default** mode (a flat 2% fee, with 25% of post-migration fees compounded back into the pool's liquidity), but **85% of the token supply is locked**. Use this when you want the standard 2% fee structure while keeping the large majority of supply locked. This mode graduates at **\~100 SOL** rather than the usual 85 SOL.

### \~0% Fee Mode

**Config ID:** `a7c8e1f2-3d4b-5a6c-9e0f-1b2c3d4e5f6a`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 1% | 0.5% | 0.5% | — |
| Post-migration | 0.25% | 0.0625% | 0.0625% | 0.125% |

Higher fees during the bonding curve phase to maximize early fee revenue, then reduced fees post-migration to encourage continued trading. Post-migration, 50% of fees are compounded back into the pool's liquidity.

### 1% Fee Mode

**Config ID:** `d16d3585-6488-4a6c-9a6f-e6c39ca0fda3`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 0.25% | 0.125% | 0.125% | — |
| Post-migration | 1% | 0.25% | 0.25% | 0.5% |

Lower fees during the bonding curve phase to encourage early trading volume, then a higher fee rate once the token graduates to the DAMM V2 pool. Post-migration, 50% of fees are compounded back into the pool's liquidity, deepening the order book over time.

### Price Mode

**Config ID:** `e2963a6c-441a-4862-9d80-b94e3a481cd7`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 2% | 1% | 1% | — |
| Post-migration | 2% | 0.75% | 0.75% | 0.5% |

Identical to the **Default** mode in every way (a flat 2% fee with 25% post-migration compounding), except the token launches with a **1,000 token supply**. Use this when you specifically need a 1K total supply.

### Paper Hand Tax Mode

**Config ID:** `48e26d2f-0a9d-4625-a3cc-c3987d874b9e`

| Stage | Total Fee | Protocol | Creator | Compounding |
| - | - | - | - | - |
| Pre-migration | 10% | 5% | 5% | — |
| Post-migration | 10% | 2.5% | 2.5% | 5% |

A high flat 10% fee on all trades. Post-migration, 50% of fees are compounded back into the pool's liquidity, rapidly deepening the order book. Best suited for tokens that want to maximize fee revenue and liquidity growth simultaneously.

## `enableFirstSwapWithMinFee`

When creating a fee share config, you can pass an optional boolean `enableFirstSwapWithMinFee` (default `true`) to the [Create Fee Share Config](https://docs.bags.fm/api-reference/create-fee-share-configuration.md) endpoint. When `true`, the **first** swap on the new pool pays the minimum (ending) base fee instead of the starting cliff fee.

This only matters for config types that use a **base-fee scheduler** (one whose base fee changes over time). **No current config type uses a base-fee scheduler, so this field has no effect right now** — you can safely omit it. It is retained for forward compatibility in case scheduler-based config types are introduced later.

## Choosing the Right Mode

| Goal | Recommended Mode |
| - | - |
| Simple, consistent fees | **Default** (2% / 2%) |
| Lock nearly all supply; fees that fall as the token grows | **Low Float** |
| Standard 2% fees with most supply locked | **Drop Mode** |
| Maximize early fee revenue, encourage post-graduation volume | **\~0% Fee Mode** (1% / 0.25%) |
| Encourage early trading, earn more post-graduation | **1% Fee Mode** (0.25% / 1%) |
| Default fees, but a 1,000 token supply | **Price Mode** |
| Maximize fee revenue and liquidity growth | **Paper Hand Tax Mode** (10% / 10%) |

> [!NOTE]
>
> The `bagsConfigType` is set once when creating the fee share config and cannot be changed after the token is launched. Choose your fee structure carefully before launching.

## Graduation Thresholds

SOL-quoted tokens launch on a bonding curve and **graduate** (migrate to a DAMM V2 pool) once they raise a set amount of SOL. Most modes graduate at **85 SOL**; **Drop Mode** and **Low Float** differ.

| Mode | SOL to graduate |
| - | - |
| Default | 85 SOL |
| Low Float | 80 SOL |
| Drop Mode | \~100 SOL |
| \~0% Fee Mode | 85 SOL |
| 1% Fee Mode | 85 SOL |
| Price Mode | 85 SOL |
| Paper Hand Tax Mode | 85 SOL |

## Custom Quote Configurations

For a non-WSOL bonding-curve launch, use [Create Custom Quote Fee Share Config Plan](https://docs.bags.fm/api-reference/create-fee-share-config-v2.md). Bags administrators configure each supported quote mint and type. [Supported Custom Quote Tokens](https://docs.bags.fm/api-reference/get-supported-quote-tokens.md) lists those entries under `flows[].configs`, with each `configType` and its `graduationThresholdRaw`.

The six supported types use the same Config IDs listed above:

| Type | Pre-migration fee | Post-migration fee | Compounding |
| - | - | - | - |
| Default | 2% | 2% | None |
| Low Float | 2% | 2% → 0.5% by market cap | None |
| \~0% Fee Mode | 1% | 0.25% | None |
| 1% Fee Mode | 0.25% | 1% | None |
| Price Mode | 2% | 2% | None |
| Paper Hand Tax Mode | 10% | 10% | None |

Only types configured for the selected quote can be issued. **Drop Mode** is unavailable for custom quotes. Omitting `bagsConfigType` selects Default; it does not select another type if the quote has no Default entry.

These configurations collect fees only in the quote token before and after graduation. They retain the selected type's base supply, fee rates, liquidity distribution, vesting, and scheduler, with **zero compounding**, even for types that compound fees on SOL. Default retains a one-billion-token base supply; Price Mode retains 1,000.

The graduation threshold is quote-denominated. When an admin saves an entry without a threshold, it defaults to `85 × 10^quoteDecimals` raw units. A six-decimal quote therefore defaults to `"85000000"`: 85 unscaled quote tokens, with no USD conversion. An issuer display multiplier can change the displayed quantity. Read the actual saved threshold from discovery; the public config and launch requests cannot override it.

Launch parameters are saved when the Fee Share config is issued. Later admin edits affect future issuance only. See [Launch a Token with a Custom Quote](https://docs.bags.fm/how-to-guides/launch-token-non-sol-quote.md) for selection, configuration, and launch examples.

## Alternative: Using the Bags CLI

> [!NOTE]
>
> This section requires the Bags CLI. See [Install and Set Up the Bags CLI](https://docs.bags.fm/cli/install-and-setup.md) to get started.

You can create and manage fee share configurations directly from the terminal:

**Create a fee share config:**

```bash theme={null}
bags config create \
  --mint TOKEN_MINT \
  --fee-claimers '[{"user":"WALLET_A","userBps":5000},{"user":"WALLET_B","userBps":5000}]'
```

**Update an existing config (requires admin authority):**

```bash theme={null}
bags config update \
  --mint TOKEN_MINT \
  --fee-claimers '[{"user":"WALLET_A","userBps":7000},{"user":"WALLET_B","userBps":3000}]'
```

**Transfer admin authority to another wallet:**

```bash theme={null}
bags config transfer-admin --mint TOKEN_MINT --new-admin NEW_ADMIN_PUBKEY
```

**List all tokens where you are admin:**

```bash theme={null}
bags config admin-list
```

Add `--skip-confirm` to any command to bypass the confirmation prompt.

## What is Fee Compounding?

All seven SOL fee modes enable **fee compounding** after migration. This means that a portion of the trading fees collected post-migration are automatically reinvested into the DAMM V2 pool's liquidity rather than being distributed. This deepens the pool over time, leading to tighter spreads and better trading conditions for the token. Non-WSOL configurations use zero compounding.

The **Default** mode and the three Default variants (**Low Float**, **Drop Mode**, and **Price Mode**) compound **25%** of post-migration fees, while the other three modes (**\~0% Fee Mode**, **1% Fee Mode**, and **Paper Hand Tax Mode**) compound **50%**. The remaining fees are split equally between the platform and gross claimers pools.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.