Solana Token-2022 Transfer Fee Extension Explained
The Solana Token-2022 transfer fee extension in plain words: basis points, fee caps, withheld tax, harvest and withdraw, authorities, DEX support.
By Solana Token Creator ·
A Solana tax token is a Token-2022 token with the transfer fee extension switched on. The official Token-2022 transfer fee extension documentation is written for developers: it lists instructions and account fields. This guide explains the same mechanics in plain language: how the fee is calculated, where the withheld tokens sit, how they are collected, who can change the rate and how DEXes handle it. If you already know you want one, the Solana tax token creator sets every option below in one form.
What the Token-2022 transfer fee extension does
Solana has two token programs. The original one, used by most SPL tokens, moves tokens and nothing more. Token-2022 is a newer program with optional extensions that are switched on when the mint is created. The transfer fee extension is one of them: it tells the program to hold back a share of every transfer of that token.
There is no custom smart contract and no code you deploy. The rule lives in the mint account itself, and the token program enforces it on every transfer, whichever wallet, DEX or app sends it. That also means it cannot be added to an existing classic SPL token; the extension has to be chosen when the mint is created.
How the fee is calculated: basis points and a cap
The extension stores two numbers:
- The rate, in basis points. One basis point is 0.01%, so 100 basis points is 1% and 10,000 would be 100%. The program accepts up to 10,000; our creator caps it at 10%.
- The maximum fee, in the token's smallest units. However large a transfer is, it never pays more than this. Leave it unset (the largest possible number) and every transfer pays the full rate.
The fee is the amount times the rate, rounded up to the next smallest unit, then capped at the maximum. Here is a 3% tax, first with no cap and then with a cap of 10,000 tokens:
| Transfer | Fee, no cap | Fee, capped | Received, capped |
|---|---|---|---|
| 1,000 | 30 | 30 | 970 |
| 100,000 | 3,000 | 3,000 | 97,000 |
| 1,000,000 | 30,000 | 10,000 | 990,000 |
The cap is useful when large transfers are expected, such as moving tokens between your own wallets or depositing into a pool. Note that the cap is a token amount, not a value in SOL, so its real-world size changes with the price.
Who pays the transfer fee?
The fee comes out of the amount being sent. The sender's balance drops by the full amount, and the recipient is credited the amount minus the fee. So in practice the receiver ends up with less:
- On a buy, the pool sends tokens to the buyer, and the buyer receives them net of the tax.
- On a sell, the seller sends tokens to the pool, and the pool receives them net of the tax, so the seller gets SOL for the smaller amount.
- Wallet to wallet, the recipient gets the net amount.
Minting is not a transfer, so the initial supply arrives in your wallet untaxed. Every movement after that, including your own deposit into a liquidity pool, pays it.
Where the fee goes: withheld amounts
The tax is not sent anywhere when a transfer happens. It stays in the recipient's own token account, in a separate "withheld" field that the owner of that account cannot spend. This design keeps transfers fast: a transfer only touches the sender and the recipient, never a central tax wallet that every trade would have to write to.
The result is that, after a day of trading, the tax is scattered across every account that received the token: buyers' wallets, the pool's vault, anyone who was sent a few tokens. Collecting it is a separate step.
Harvest and withdraw: how the tax is collected
Token-2022 offers three instructions for getting the withheld tokens out:
| Instruction | What it does | Who can call it |
|---|---|---|
| Withdraw from accounts | Moves withheld tax from a list of token accounts straight to a wallet you pick | The withdraw authority only |
| Harvest to mint | Sweeps withheld tax from token accounts into the mint account itself | Anyone |
| Withdraw from mint | Moves everything harvested into the mint out to a wallet | The withdraw authority only |
Harvesting is open to anyone on purpose. A holder who wants to close their token account cannot do so while it still holds withheld tax, so they can harvest it to the mint first and then close. The tax is not lost; it just moves to the mint, where the withdraw authority can collect it later.
In practice, collection tools find every account of your token that holds withheld tax, withdraw it in batches (a Solana transaction can only list so many accounts) and send it to the collecting wallet. You receive the tax in your own token, not in SOL. If you want SOL, you sell it like any other holder, and that sale pays the tax too.
The two authorities, and what buyers think of them
A transfer fee token has two authorities of its own, on top of mint and freeze:
- Transfer fee config authority. Can change the rate and the cap. A new rate does not apply at once: Token-2022 keeps the old and new settings side by side and switches at the start of the second epoch after the change, so at least one full epoch later. That delay gives holders time to react to a rate change.
- Withdraw withheld authority. The only key that can collect the tax. It decides where the money goes, not how much is charged.
Buyers care most about the first one. A token whose rate can still change could, in principle, be set from 2% to the program's maximum later, so many traders and rug checkers treat an active config authority as a risk (see how checkers rate tax tokens). Removing it (locking the rate) is the clearest signal that the tax you advertise is the tax they will pay forever. The withdraw authority is expected to stay: someone has to collect the tax.
How our tax token creator sets these up
The form has four tax settings, and each maps to the extension directly:
- Tax per transfer: from 0.01% up to the cap in steps of 0.01% (one basis point).
- Cap per transfer: optional, in whole tokens; empty means no cap.
- Tax wallet: the withdraw authority. It defaults to your connected wallet, or you can paste another address, such as a team multisig.
- Lock the tax rate: creates the token with no config authority at all, so nobody can change the rate or cap again. Locking is included at no extra charge.
The metadata (name, symbol, logo link) lives inside the mint through Token-2022's own metadata extension, so no separate metadata account is needed. Everything happens in one transaction that your wallet signs after the review step.
Do DEXes and routers support transfer fee tokens?
Support depends on the pool program, and each DEX publishes its own Token-2022 rules. As of November 2026:
| Venue | Transfer fee tokens |
|---|---|
| Raydium CPMM and CLMM | Accepted. Token-2022 mints pass an extension allow-list, and the transfer fee is on it. |
| Raydium AMM v4 | No Token-2022 support at all. |
| Meteora DAMM v2 and DLMM | Accepted without extra approval. DLMM gives mints with a freeze authority extra review. |
| Jupiter | Its docs say tokens that charge a transfer fee are accepted on market swaps and limit orders. |
Inside a supported pool, the math accounts for the fee. When you sell, the pool counts only what actually arrives after the tax, and when you buy, you receive the pool's output minus the tax. Quotes from a router that understands the extension already include it, so a buyer sees the net amount before signing.
Our pool creator opens Raydium CPMM and Meteora DAMM v2 pools, and it checks the mint against the chosen DEX's rules before your wallet opens. Expect your own deposit to arrive net of the tax: put in 1,000,000 tokens with a 3% tax and no cap, and the pool receives 970,000. A per-transfer cap keeps that loss small for large deposits.
How to collect the tax
Collection uses the withdraw instructions above, signed by the tax wallet. Any tool that builds those instructions works: it finds accounts with withheld tax, withdraws in batches and sends the tokens to the tax wallet. Our site creates the token and sets the tax wallet; it does not collect tax for you. Choose that wallet carefully at creation, because only it can ever withdraw.
Collecting is not urgent. Withheld tax does not expire, and if holders harvest it to the mint while closing their accounts, it waits there for the tax wallet.
What a tax token costs to create
The same as a regular token: 0.1 SOL, plus 0.04 SOL for each authority you revoke at creation, plus rent for the mint and your token account. Locking the rate is included. The review step shows the exact total before you sign. If you do not need a tax, the standard Solana token creator makes a classic SPL token for the same fee.
Common mistakes
- Leaving the rate unlocked by accident. Buyers and checkers will flag it. Lock it unless you have a published reason to keep it.
- A high rate. Every trade pays it twice in a round trip, once in and once out. A 10% tax costs a trader about a fifth of their money just to buy and sell.
- Choosing a pool type that does not accept Token-2022, such as Raydium AMM v4.
- Setting the tax wallet to an address you cannot sign with. The tax would be stuck forever.
For how Token-2022 differs from the classic program beyond fees, read SPL vs Token-2022. To plan the rest of the launch, see tokenomics for a new token.
Frequently asked questions
How does a Solana tax token work?
The mint carries a transfer fee setting. On every transfer the token program withholds that share in the recipient's account, and the tax wallet collects it later.
Who pays the transfer fee?
It is taken from the amount sent, so the recipient receives less: the buyer on a buy, the pool on a sell.
Can the tax be changed later?
Only by the fee config authority, and a change takes effect at the start of the second epoch after it. If the rate was locked at creation, nobody can change it.
How do I collect fees?
Sign a withdraw from the tax wallet, using a tool that gathers withheld tax from token accounts and the mint. The tokens arrive in that wallet.
Do Raydium and Jupiter support fee tokens?
Raydium CPMM and CLMM do, AMM v4 does not, and Jupiter's docs list fee-charging tokens as accepted on market swaps and limit orders. To create one, use the tax token creator.