Swap Protocol

Complete guide to Omniston Swap Protocol - integrate cross-DEX swapping capabilities into your TON applications

Liquidity aggregation protocol for optimal swap execution on TON.

Documentation

Overview

Basic concepts and integration guide

Advanced Features

Advanced protocol capabilities and features

gRPC Integration

High-performance integration using gRPC

Key Features

• Aggregation: Combines liquidity from multiple sources

• Optimization: Finds best routes and prices

• Real-time: WebSocket support for live quotes

Integration Options

Recommended: We strongly recommend using our official SDKs for Omniston integration. They handle WebSocket connections, quote streaming, transaction building, and error handling out of the box.

SDKs (Recommended)

SDK	Use Case	Documentation
Node.js SDK	Backend services, bots, scripts	Full-featured with RxJS Observables
React SDK	Frontend applications	Ready-to-use hooks with TanStack Query

See SDK Overview for installation and quick start examples.

Low-Level Integration

For developers who need direct protocol access or are working in languages other than TypeScript/JavaScript:

• Python Quickstart Guide - Complete working example showing WebSocket communication, quote requests, and transaction building. Use this as a reference to implement in your preferred language.

• SDK Source Code - Our SDKs are fully open-source. Study the actual low-level implementation to understand WebSocket handling, message formatting, and transaction building in detail.

• WebSocket API - Real-time quotes and updates (documented in Overview)

• gRPC - High-performance integration for advanced use cases

Learn More

Visit omniston.ston.fi for more information.