# Omniston Protocol

## Overview

Omniston is a liquidity aggregation protocol for TON blockchain and cross-chain swaps. It aggregates liquidity from various sources, including:

* TON AMM DEXs
* TON on-chain RFQ resolvers
* Cross-chain liquidity through HTLC-based atomic swaps

Omniston uses the same RFQ flow for both TON and cross-chain swaps. The Request for Quote (RFQ) mechanism lets users request quotes from connected resolvers and select the best available terms.

Via cross-chain, the user provides the input asset on the source blockchain and receives the output asset on the destination blockchain. Cross-chain settlement is handled through HTLC-based atomic swaps.

`v1beta8` introduces native cross-chain support in Omniston, requiring a more explicit and consistent API model. It defines source and destination blockchains as separate fields, separates swap and order settlement flows, and standardizes terminology across API, SDK, and docs. This allows a single integration to support multiple settlement modes.

{% hint style="success" %}
**Omniston demo app is live!** See [omniston.ston.fi](https://omniston.ston.fi/)
{% endhint %}

## Key Benefits

Omniston provides:

* Provides users with the best pricing conditions
* Access to a wide range of tokens across connected liquidity sources
* One RFQ flow for TON and cross-chain swaps
* Flexibility to set fees
* SDKs and low-level APIs for different integration needs

## Use Case

For example, when a user wants to swap Token **A** for Token **B**, they initiate a swap request through Omniston. The protocol collects quotes from connected liquidity sources and returns executable terms. Depending on the selected route, the swap is settled either on TON or through a cross-chain HTLC-based flow.

## Swap

To perform a swap with Omniston, see the [Swap overview](/developer-section/omniston/swap.md).

## Integration Options

Omniston supports three integration approaches:

1. **SDK (recommended)** — easiest way to add swaps ([Node.js](/developer-section/omniston/sdk/nodejs.md) / [React](/developer-section/omniston/sdk/react.md)).
2. **WebSocket (JSON-RPC)** — low-level API for custom integrations.
3. **gRPC (TLS)** — primary low-level API for backend integrations and resolvers.

For information about implementing referral fees in your application, see the [Referral Fees guide](/developer-section/omniston/referral-fees.md).

## Demo Application

The source code for the [demo application](https://omniston.ston.fi) is available on [GitHub](https://github.com/ston-fi/omniston-sdk/tree/main/examples/react-app).


---

# 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.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.