Omniston Protocol

Build swap aggregation solutions for TON and cross-chain execution with Omniston

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.

Omniston demo app is live! See omniston.ston.fi

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.

Integration Options

Omniston supports three integration approaches:

1. SDK (recommended) — easiest way to add swaps (Node.js / React).

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.

Demo Application

The source code for the demo application is available on GitHub.