# Introduction

![](https://1159777691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJ1ZKietYw2GrKAuOqA8%2Fuploads%2Fgit-blob-f9cf122f0c1ebaef43ed75680fc876bccd77fc9a%2FStonfi-Intro.jpg?alt=media)

## What Is STON.fi?

[STON.fi](https://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](https://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

**Embed a swap feature and earn fees - in minutes**

The [STON.fi (swap) Widget](https://docs.ston.fi/developer-section/widget) 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 [STON.fi (swap) Widget](https://docs.ston.fi/developer-section/widget) for a drop-in swap experience, then explore the guides below.

### **Getting Started Guides**

* [**Swap Guide (React)**](https://docs.ston.fi/developer-section/quickstart/swap) - Integrate token swaps into your dApp
* [**Omniston Guide (React)**](https://docs.ston.fi/developer-section/quickstart/omniston) - Use our cross-chain aggregator for best rates
* [**Liquidity Providing Guide (React)**](https://docs.ston.fi/developer-section/quickstart/liquidity) - Add and manage liquidity pools
* [**Omniston Guide (Python)**](https://docs.ston.fi/developer-section/quickstart/python) - Build a terminal-based swap client in Python

### **Developer Resources**

* [**Omniston Protocol**](https://docs.ston.fi/developer-section/omniston) - Cross-chain swaps and aggregation
* [**SDK Documentation**](https://docs.ston.fi/developer-section/dex/sdk) - TypeScript/JavaScript SDK for easy integration
* [**Smart Contract APIs**](https://docs.ston.fi/developer-section/dex/smart-contracts) - Direct contract interaction
* [**DEX API Reference**](https://docs.ston.fi/developer-section/dex/api) - REST API for data queries
* [**Architecture Overview**](https://docs.ston.fi/developer-section/dex/architecture) - Technical deep dive
* [**Becoming a Resolver**](https://docs.ston.fi/developer-section/omniston/resolvers/guide) - 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](https://docs.ston.fi/developer-section/dex/overview), [Fees](https://docs.ston.fi/developer-section/dex/fees), [Smart Contracts](https://docs.ston.fi/developer-section/dex/smart-contracts), [SDK v2](https://docs.ston.fi/developer-section/dex/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](https://docs.ston.fi/developer-section/omniston/overview), [Omniston SDK](https://docs.ston.fi/developer-section/omniston/sdk), [Resolvers Guide](https://docs.ston.fi/developer-section/omniston/resolvers/guide), [Referral Fees](https://docs.ston.fi/developer-section/omniston/referral-fees)

## 📚 Documentation Structure

This documentation provides:

* **Technical specifications** for protocol integration — [DEX Architecture](https://docs.ston.fi/developer-section/dex/architecture), [Smart Contracts](https://docs.ston.fi/developer-section/dex/smart-contracts)
* **Code examples** for common operations — [Quickstart Guides](https://docs.ston.fi/developer-section/quickstart), [Smart Contract Examples](https://docs.ston.fi/developer-section/dex/smart-contracts/v2/examples)
* **API references** for all contracts and endpoints — [Smart Contracts](https://docs.ston.fi/developer-section/dex/smart-contracts), [DEX API Reference](https://docs.ston.fi/developer-section/dex/api/reference)
* **Best practices** for optimal implementation — [Architecture Overview](https://docs.ston.fi/developer-section/dex/architecture), [Quickstart Guides](https://docs.ston.fi/developer-section/quickstart)

## 🔗 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>
* **Discord**: <https://discord.com/invite/bdmaGV6qUw>
* **Reddit**: <https://www.reddit.com/r/Stonfiers>
* **LinkedIn**: <https://www.linkedin.com/company/ston-fi/>
* **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](https://docs.ston.fi/developer-section/quickstart) or explore the [SDK Documentation](https://docs.ston.fi/developer-section/dex/sdk)!
