If you're building a wallet, dApp, or bot on TON, you can offer your users STON.fi swaps without sending them off-site. There are two main paths — pick the one that matches how much control you need.
Path 1: Drop in the Omniston Widget (simplest)
The Omniston Widget is a ready-made swap UI you embed via a one-line CDN script or an npm package. Your users get the full STON.fi swap experience inside your app, and your wallet may receive referral fees on every swap.
Choose this when you want swaps available quickly, the default UI is acceptable (or themeable with CSS variables), and you don't need to control the swap flow at a low level. See Can I embed the STON.fi swap widget in my app?
Path 2: Build directly on the SDK or API
For full control of the swap flow (custom UI, batching, routing logic), integrate at the protocol level using the STON.fi SDK and API.
The implementation details (SDK, API, smart-contract entry points, referral mechanics) change as the protocol evolves, so rather than restating them here, we point you to the up-to-date documentation:
- Full developer documentation: docs.ston.fi
- Interactive API reference: api.ston.fi
For integration questions or access to the STON.fi developer chat, contact STON.fi support.