> For the complete documentation index, see [llms.txt](https://ston-fi.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ston-fi.gitbook.io/docs/developer-section/omniston/swap.md).

# Swap Protocol

Liquidity aggregation protocol for optimal swap execution on TON.

## Documentation

### [Overview](/docs/developer-section/omniston/swap/overview.md)

Basic concepts and integration guide

### [Advanced Features](/docs/developer-section/omniston/swap/advanced.md)

Advanced protocol capabilities and features

### [gRPC Integration](/docs/developer-section/omniston/swap/grpc.md)

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](/docs/developer-section/omniston/sdk/nodejs.md) | Backend services, bots, scripts | Full-featured with RxJS Observables    |
| [React SDK](/docs/developer-section/omniston/sdk/react.md)    | Frontend applications           | Ready-to-use hooks with TanStack Query |

See [SDK Overview](/docs/developer-section/omniston/sdk.md) 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**](/docs/developer-section/quickstart/python.md) - 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**](https://github.com/ston-fi/omniston-sdk) - 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](/docs/developer-section/omniston/swap/overview.md))
* [**gRPC**](/docs/developer-section/omniston/swap/grpc.md) - High-performance integration for advanced use cases

## Learn More

Visit [omniston.ston.fi](https://omniston.ston.fi) for more information.