arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Introduction

STON.fi Developer Documentation - Build on TON's leading DEX with comprehensive guides, SDK references, and API docs

hashtag
What Is STON.fi?

STON.fiarrow-up-right 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.fiarrow-up-right) provides a visual interface for interacting with smart contracts deployed on TON.

hashtag
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

hashtag
🚀 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.

hashtag
Getting Started Guides

  • - Integrate token swaps into your dApp

  • - Use our cross-chain aggregator for best rates

  • - Add and manage liquidity pools

hashtag
Developer Resources

  • - Cross-chain swaps and aggregation

  • - TypeScript/JavaScript SDK for easy integration

  • - Direct contract interaction

hashtag
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.

hashtag
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

hashtag
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

hashtag
📚 Documentation Structure

This documentation provides:

  • Technical specifications for protocol integration — ,

  • Code examples for common operations — ,

  • API references for all contracts and endpoints — ,

hashtag
🔗 Quick Links

Main Resources:

  • Website:

  • Web App:

  • User Guide:

Community:

  • X (Twitter):

  • Telegram:

  • Discord:

hashtag
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

hashtag
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

  • Omniston Guide (Python) - Build a terminal-based swap client in Python
    DEX API Reference - REST API for data queries
  • Architecture Overview - Technical deep dive

  • Becoming a Resolver - Participate in our network

  • Fees configurable per pool — see Fees
  • Learn more: DEX Overview, Fees, Smart Contracts, SDK v2

  • Learn more:
    ,
    ,
    ,

    Best practices for optimal implementation — Architecture Overview, Quickstart Guides

    Blog: https://blog.ston.fi/arrow-up-right
  • Omniston: https://ston.fi/omnistonarrow-up-right

  • GitHub: https://github.com/ston-fi/arrow-up-right

  • Reddit: https://www.reddit.com/r/Stonfiersarrow-up-right
  • LinkedIn: https://www.linkedin.com/company/ston-fi/arrow-up-right

  • YouTube: https://www.youtube.com/@stonfidexarrow-up-right

  • CoinMarketCap Community: https://coinmarketcap.com/community/profile/ston_fi/arrow-up-right

  • TikTok: https://www.tiktok.com/@ston.fiarrow-up-right

  • Instagram: https://www.instagram.com/stonfidefiarrow-up-right

  • Operates 24/7 without intermediaries
    STON.fi (swap) Widget
    STON.fi (swap) Widget
    Swap Guide (React)
    Omniston Guide (React)
    Liquidity Providing Guide (React)
    Omniston Protocol
    SDK Documentation
    Smart Contract APIs
    DEX Architecture
    Smart Contracts
    Quickstart Guides
    Smart Contract Examples
    Smart Contracts
    DEX API Reference
    https://ston.fi/arrow-up-right
    https://app.ston.fi/arrow-up-right
    https://guide.ston.fi/en/arrow-up-right
    https://x.com/ston_fiarrow-up-right
    https://t.me/stonfidexarrow-up-right
    https://discord.com/invite/bdmaGV6qUwarrow-up-right
    Quickstart Guides
    SDK Documentation
    Omniston Overview
    Omniston SDK
    Resolvers Guide
    Referral Fees