STON.fi Developer Documentation - Build on TON's leading DEX with comprehensive guides, SDK references, and API docs
What Is STON.fi?
STON.fi is the leading decentralized automated market maker (AMM) exchange on the TON blockchain, employing the Constant Product Market Maker algorithm. The web-based app (app.ston.fi) provides a visual interface for interacting with smart contracts deployed on TON.
Key Features
Fully Decentralized - Non-custodial exchange with funds held in permissionless smart contracts
Low slippage - Deep liquidity pools ensure optimal trading rates
🚀 Quick Start for Developers
Embed a swap feature and earn fees - in minutes
The is a ready-to-use swap interface for your app or website. Simply embed our lightweight script and get full swap functionality instantly — while you earn fees from every swap. Start with the default config or customize colors and token lists to match your brand.
Whether you're building on STON.fi or integrating our protocol, here's where to begin. If you are new to TON development or just want the fastest integration path, start with our for a drop-in swap experience, then explore the guides below.
Getting Started Guides
- Integrate token swaps into your dApp
- Use our cross-chain aggregator for best rates
- Add and manage liquidity pools
Developer Resources
- Cross-chain swaps and aggregation
- TypeScript/JavaScript SDK for easy integration
- Direct contract interaction
STON.fi Products
STON.fi builds user‑centric DeFi on TON. Our main products are the STON.fi DEX and Omniston aggregator, supported by SDKs, APIs, and a production web app.
What Is the STON.fi DEX?
A permissionless automated market maker (AMM) enabling token swaps and liquidity provision on TON.
Constant Product (x*y=k) pools with deep liquidity
Non‑custodial contracts and time‑locked router upgrades
Liquidity provision and yield farming
What Is Omniston?
Omniston is STON.fi’s aggregation layer that finds best rates by combining on‑chain liquidity sources and RFQ resolvers.
Optimal routing across pools and resolvers
Referral fee support and advanced features
SDKs for seamless integration
📚 Documentation Structure
This documentation provides:
Technical specifications for protocol integration — ,
Code examples for common operations — ,
API references for all contracts and endpoints — ,
🔗 Quick Links
Main Resources:
Website:
Web App:
User Guide:
Community:
X (Twitter):
Telegram:
Discord:
What Is an AMM?
An Automated Market Maker (AMM) is a decentralized trading protocol that:
Uses liquidity pools instead of order books
Provides instant trades without counterparties
Allows anyone to become a liquidity provider
Why Build on STON.fi?
For Developers:
Comprehensive SDKs and documentation
Battle-tested smart contracts
Active developer community
Direct team support
For Users:
Largest liquidity on TON
Best rates through aggregation
Seamless Telegram integration
Trusted by millions
Ready to start building? Jump to our or explore the !
No front-running - TON's advanced sharding and async architecture prevent manipulation
Immutable contracts - Pool contracts cannot be modified, ensuring fund security
Time-locked upgrades - Router updates have a 7-day lock period for transparency