Introduction
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
Near-zero fees - Minimal transaction costs leveraging TON's efficiency
Low slippage - Deep liquidity pools ensure optimal trading rates
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
🚀 Quick Start for Developers
Whether you're building on STON.fi or integrating our protocol, here's where to begin:
Getting Started Guides
Swap Guide (React) - Integrate token swaps into your dApp
Omniston Guide (React) - Use our cross-chain aggregator for best rates
Liquidity Providing Guide (React) - Add and manage liquidity pools
Omniston Guide (Python) - Build a terminal-based swap client in Python
Developer Resources
Omniston Protocol - Cross-chain swaps and aggregation
SDK Documentation - TypeScript/JavaScript SDK for easy integration
Smart Contract APIs - Direct contract interaction
DEX API Reference - REST API for data queries
Architecture Overview - Technical deep dive
Becoming a Resolver - Participate in our network
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
Fees configurable per pool — see Fees
Learn more: DEX Overview, Fees, Smart Contracts, SDK v2
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
Learn more: Omniston Overview, Omniston SDK, Resolvers Guide, Referral Fees
📚 Documentation Structure
This documentation provides:
Technical specifications for protocol integration — DEX Architecture, Smart Contracts
Code examples for common operations — Quickstart Guides, Smart Contract Examples
API references for all contracts and endpoints — Smart Contracts, DEX API Reference
Best practices for optimal implementation — Architecture Overview, Quickstart Guides
🔗 Quick Links
Main Resources:
Website: https://ston.fi/
Web App: https://app.ston.fi/
User Guide: https://guide.ston.fi/en/
Blog: https://blog.ston.fi/
Omniston: https://ston.fi/omniston
GitHub: https://github.com/ston-fi/
Community:
X (Twitter): https://x.com/ston_fi
Telegram: https://t.me/stonfidex
Reddit: https://www.reddit.com/r/STONFi/
YouTube: https://www.youtube.com/@stonfidex
CoinMarketCap Community: https://coinmarketcap.com/community/profile/ston_fi/
TikTok: https://www.tiktok.com/@ston.fi
Instagram: https://www.instagram.com/stonfidefi
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
Operates 24/7 without intermediaries
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 Quickstart Guides or explore the SDK Documentation!
Last updated