# Swap Protocol

Liquidity aggregation protocol for optimal swap execution on TON.

## Documentation

### [Overview](https://docs.ston.fi/developer-section/omniston/swap/overview)

Basic concepts and integration guide

### [Advanced Features](https://docs.ston.fi/developer-section/omniston/swap/advanced)

Advanced protocol capabilities and features

### [gRPC Integration](https://docs.ston.fi/developer-section/omniston/swap/grpc)

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

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

## Learn More

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