How to add a new token on STON.fi
Anyone can add a token to STON.fi by creating a v2 liquidity pool. This guide explains when it’s appropriate, how to do it safely, and how interface policies affect visibility, warnings, and swaps.
STON.fi is permissionless: new tokens become swappable by creating a liquidity pool. This guide walks you through the process, what to check beforehand, and when a token may be shown with warnings, restricted, hidden, or blocked in the interface even if the pool exists on-chain.
Before you start:
✅ Ensure you hold enough of both assets to seed the pool.
✅ Review STON.fi interface policies (taxable tokens, IP/impersonation) so you know how visibility works after creation.
When adding a token is appropriate
You’re the token issuer or an authorized contributor.
You’re listing a community token that does not violate IP or impersonate other assets.
If the token uses fee-on-transfer (“tax”) mechanics, you understand that STON.fi does not endorse such tokens and supports them only in limited cases, with user warnings and technical restrictions.
Read more on tax tokens: Tax tokens on TON: what they are and how STON.fi handles them
Step-by-step: add a token by creating a pool
Open STON.fi → Pools → Add liquidity.
In “Provide liquidity,” select the token pair for the pool (e.g., NEW/TON or NEW/USDt). If your token doesn’t appear by name, paste its contract address.
Configure the pool:
Set the initial price by choosing amounts for each side.
Review settings and click Preview pool creation.
Confirm:
Check the popup details (pool parameters, fee from your wallet).
Click Confirm pool creation and approve in your wallet. Pool creation and initial liquidity happen in one transaction.
For the exact click-paths and screenshots, follow guide How to create a new liquidity pool.
After creation
Your pool is live on-chain; swaps can route through it at the protocol level.
If the token complies with interface policies and technical restrictions, it may appear in app.ston.fi search by name. Otherwise, it may be shown with warnings, accessible only by contract address, restricted for certain swap routes, hidden, or blocked depending on the case.
Token labels and visibility in the interface
Labeled tokens: Some tokens are not shown by name in the interface and can only be found by entering their smart contract address manually. This helps users make a conscious decision before interacting. Always verify the contract address and token mechanics before proceeding.
Blacklisted: Some labeled tokens are not available for interaction in the STON.fi dApp interface, even if the contract address is entered manually. This may apply to tokens labeled as Fake or Honeypot, where the risk pattern is clear enough to prevent app-level interaction. These labels and restrictions affect only the STON.fi app interface. A labeled token may still exist on-chain and may be accessible through direct smart contract interaction, programmatically, or via other interfaces.
Important limits: taxable tokens (fee-on-transfer)
To keep swaps predictable and safe, STON.fi treats taxable tokens as a special-risk category. The interface supports taxable tokens only in limited cases, shows users a clear warning, and applies technical restrictions because transfer deductions can affect received amounts and make routing less predictable. Taxable tokens cannot be used as intermediate assets in routes, and tokens with a transfer tax above 10% are not supported for swaps.
You can still create a pool for a tax token at the protocol level.
However, app.ston.fi will handle the token according to its taxable-token rules: the UI will show a warning, the token cannot be used as an intermediate asset in routes, and swaps are not supported if the transfer tax is above 10%.
Other third-party interfaces may still access the pool directly via the blockchain. Use caution and do your own research.
Important limits: intellectual property and impersonation
Per our Terms of Use, STON.fi hides tokens that:
impersonate known assets (e.g., fake “USDt”, “BTC”),
misuse brands, names, logos, or characters without permission,
claim affiliation with legitimate projects when they are not.
Meme tokens are welcome when they’re original. Direct copies of protected brands are not.
FAQ
❓ Can I add a token name/logo? Token metadata is read from the ecosystem’s token registries and community resources. Names/logos may take time to propagate; always share the contract address so users can verify. ❓ Why don’t I see my token by name? It may be new because metadata has not propagated yet, hidden by policy, restricted for swaps on STON.fi if it violates safety rules. Users may still be able to paste the contract address. Taxable tokens can still carry warnings and swap restrictions. ❓ Can I create multiple pools for the same token? Yes, but liquidity fragmentation can worsen swap conditions. It’s usually better to build depth in one or two key pairs (e.g., NEW/TON or NEW/USDt). ❓ Does STON.fi “list” tokens? No approvals are needed at the protocol level. The UI applies safety filters to protect users; the protocol itself remains open and decentralized.
Last updated