★ How to get referral fees from swaps?
Get a percentage of swaps made through your referral link on STON.fi DEX. Simply create a referral link by appending your wallet address to the URL and share it with friends.
STON.fi offers a referral program that encourages users to share referral links and earn commissions. The structure of referral commissions varies between V1 and V2 pools.
Key Referral Commission Differences Between V1 and V2 Pools
Parameter
V1
V2
Default referral percentage
0.1%
Customizable (0.0% – 1.0%)
Commission distribution
Automatic to wallet
Accumulates in vaults
Manual withdrawal required
No
Yes
Flexibility in referral percentage
No
Yes
Transaction cost
Higher (referral fee is sent immediately to the referrer during the swap)
Lower (referral fee accrues in a vault; not transferred during the swap)
V1 referral commission
Default referral commission In V1, users can share a referral link to receive a default commission of 0.1% from any swaps made through their link. Example referral link: https://app.ston.fi/swap?chartVisible=false&ft=TON&tt=STON&referral_address=<referral_address>
Automatic distribution The commission is automatically credited to the wallet that owns the referral_address. No extra action is required.
Simplified workflow The commission is transferred immediately, which offers instant rewards for referrers. However, the swapping user pays a slightly higher gas/processing cost because the referral token transfer occurs within the swap transaction.
V2 referral commission
Customizable referral percentage In V2, the referral commission can be set by adding the referral_percent parameter to the link. The value can range from 0% (0 bps) to 1% (100 bps). Note: referral_percent is a decimal (e.g., 0.1 = 0.1%). Example referral link (custom commission): https://app.ston.fi/swap?chartVisible=false&ft=TON&tt=STON&referral_address=<referral_address>&referral_percent=0.1
Accrued commission in vaults Commissions do not distribute automatically. Instead, they accumulate in vault contracts associated with the pools. As a result, the swapping user pays less because no immediate referral transfer is made.
Manual withdrawal, how to claim:
Open: https://sdk-demo-app.ston.fi/vault
Connect your wallet and review available referral fees for your address and click Claim on the ones you want.
Approve the transaction in your wallet.
After confirmation, the claimed fees will appear in your wallet.
Withdrawal
Referrers must manually request the accumulated commission from the vault.
This is done by sending a withdrawal request to the vault contract.
Docs: https://docs.ston.fi/developer-section/omniston/omniston-referral-fees#id-2-withdrawing-your-fees
Increased flexibility Referrers can set the commission to match their strategy (e.g., 0% for growth, 0.05%–0.2% for light incentives, up to 1% for high‑touch campaigns).
Applicability of referral program
The referral program applies to all swaps performed after opening the DEX through the referral link.
The referral context resets if the page is refreshed, the app is closed, or the user operates in another tab/session.
FAQ
Does the 0.1% referral commission add extra cost or is it paid from the protocol fee? Referral commissions are always added on top, making the exchange more expensive for the user by the amount of the referral commission.
What happens if the &referral_percent= parameter is used for V1 pools? It is ignored. For V1 pools, the referral percentage is always 0.1% if a referral_address is specified.
In which token is the referral commission accrued? In the input token. Example: for USDT → STON, the input token is USDT, so the commission accrues in USDT.
Does the referral commission apply to one swap or multiple swaps? It applies to all swaps performed after opening the DEX via the referral link, until the referral context resets (page refresh, app closure, another tab/session).
What happens if a value greater than 1% is set for referral_percent? The system automatically applies the maximum allowed value of 1%.
What happens if &referral_percent= is not specified? The default value of 0.1% is applied.
Can anyone request the referral commission withdrawal? Anyone can send a withdrawal request, but only the vault owner receives the rewards. The claim message simply triggers distribution to the vault owner.
What happens if a non‑owner requests a withdrawal? The non‑owner receives nothing. All rewards are sent to the vault owner.
At‑a‑glance: building links
Minimum V1 link https://app.ston.fi/swap?ft=<FROM>&tt=<TO>&referral_address=<WALLET>
Minimum V2 link with custom rate https://app.ston.fi/swap?ft=<FROM>&tt=<TO>&referral_address=<WALLET>&referral_percent=<0.0–1.0>
Reminder: If you need a visual walkthrough or screenshots for claiming V2 rewards, use the tutorial.
Last updated