Overview (Omniston)

Learn about Omniston protocol - STON.fi's cross-chain aggregation for optimal swap routes across multiple DEXs on TON

Omniston is a liquidity aggregation protocol for the TON blockchain that finds the best swap rates by pulling liquidity from various sources.

What is Omniston?

Omniston aggregates liquidity from multiple sources to provide:

• Best possible swap rates

• Access to a wider range of tokens

• Reduced slippage on large trades

• Single interface for all liquidity sources

How It Works

1. Request: User requests a swap through Omniston

2. Aggregation: Protocol queries multiple liquidity sources

3. Routing: Finds optimal path across DEXs and resolvers

4. Execution: Performs swap through the best route

Liquidity Sources

• AMM DEXs: STON.fi and other TON DEXs

• RFQ Resolvers: On-chain market makers

• Cross-chain: Bridge liquidity (coming soon)

Key Benefits

For Users

• Always get the best price

• Access to deep liquidity

• Simple integration

• Lower slippage

For Developers

• Single SDK for all liquidity

• No need to integrate multiple DEXs

• Built-in price optimization

• Easy resolver integration

For Resolvers

• Direct market access

• Flexible fee structure

• Programmatic trading

• MEV opportunities

Integration

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.

Endpoints & Environments

Production

• WebSocket (JSON-RPC): wss://omni-ws.ston.fi

• gRPC (TLS): omni-grpc.ston.fi:443

• Demo site: omniston.ston.fi

Sandbox (public testing)

• WebSocket (JSON-RPC): wss://omni-ws-sandbox.ston.fi

• gRPC (TLS): omni-grpc-sandbox.ston.fi:443

• Demo site: omniston-sandbox.ston.fi

⚠️ gRPC endpoints are host:port targets over TLS and are not HTTP REST URLs. Do not use https://... as if it were a REST API.