# Swap Protocol

Liquidity aggregation protocol for optimal swap execution on TON.

## Documentation

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

Basic concepts and integration guide

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

Advanced protocol capabilities and features

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

See [SDK Overview](/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**](/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](/developer-section/omniston/swap/overview.md))
* [**gRPC**](/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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ston.fi/developer-section/omniston/swap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.