> For the complete documentation index, see [llms.txt](https://docs.ston.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ston.fi/getting-started/readme.md).

# Introduction

Integrate swaps across TON, TRON, and EVM networks, or build with STON.fi liquidity pools and farming on TON.

![STON.fi](https://1159777691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJ1ZKietYw2GrKAuOqA8%2Fuploads%2Fgit-blob-f9cf122f0c1ebaef43ed75680fc876bccd77fc9a%2FStonfi-Intro.jpg?alt=media)

## What Is STON.fi?

[STON.fi](https://ston.fi/) is a DeFi platform for self-custodial trading across TON, TRON, and EVM networks. It brings together liquidity aggregation, native cross-chain swaps, and liquidity pools and farming on TON.

## Services

* [Omniston](/developer-section/omniston.md): aggregate liquidity and execute swaps on TON and across chains through one integration. Resolvers provide liquidity and settle orders.
* [STON.fi DEX](/developer-section/dex.md): swap tokens, provide liquidity, and farm LP tokens on TON.

Use the [web app](https://app.ston.fi/) for swaps, liquidity provision, and farming. The [User Guide](https://guide.ston.fi/en/) explains these operations.

## Who Is STON.fi For?

STON.fi provides tools for:

* **Wallets**: integrate TON and cross-chain swaps with [Omniston](/developer-section/omniston.md).
* **Applications**: build a swap interface with the [SDK](/developer-section/omniston/sdk.md) or [API](/developer-section/omniston/swap.md), or embed the [Widget](/developer-section/widget.md).
* **Bots**: request quotes, prepare swaps, and track results with the [TypeScript and JavaScript SDK](/developer-section/omniston/sdk/nodejs.md).
* **Liquidity providers**: manage liquidity and farming on TON with the [DEX SDK](/developer-section/dex/sdk.md).
* **Resolvers**: provide quotes and settle orders through the [resolver API](/developer-section/omniston/resolvers.md).

## Developer tools

Developers can integrate STON.fi into wallets, applications, bots, and services using:

* **Omniston SDKs**: use [TypeScript and JavaScript](/developer-section/omniston/sdk/nodejs.md) or [React hooks](/developer-section/omniston/sdk/react.md) for quotes, settlement, and tracking.
* **DEX and Farm SDK**: build transactions for swaps, liquidity, and farming on TON with [`@ston-fi/sdk`](/developer-section/dex/sdk.md).
* **Direct APIs**: use Omniston over [WebSocket](/developer-section/omniston/swap/overview.md) or [gRPC with protobuf definitions](/developer-section/omniston/swap/grpc.md), and the [DEX REST API](/developer-section/dex/api.md) for pool data, simulations, and statistics.
* **Widget**: embed a configurable [swap interface](/developer-section/widget.md) in an application or website.

Start with [Quickstart](/developer-section/quickstart.md) to find the integration guide for your task.

## Why Build on STON.fi?

* **Connected liquidity**: access aggregated quotes and cross-chain execution through one Omniston integration.
* **Flexible integration**: use SDKs and APIs for a custom flow or embed the ready-made Widget.
* **Monetization**: configure [integrator fees](/developer-section/omniston/referral-fees.md) for your application.
* **Open development**: open-source tools, integration guides, and published [smart contract audits](/getting-started/security.md).
* **Developer support**: community resources and [direct team support](/help/contact.md).
* **Established ecosystem**: a platform used by millions of swappers.

## Quick Links

### Main Resources

* **Website**: [ston.fi](https://ston.fi/)
* **Web App**: [app.ston.fi](https://app.ston.fi/)
* **User Guide**: [guide.ston.fi](https://guide.ston.fi/en/)
* **Blog**: [blog.ston.fi](https://blog.ston.fi/)
* **Omniston**: [ston.fi/omniston](https://ston.fi/omniston)
* **GitHub**: [github.com/ston-fi](https://github.com/ston-fi/)

### Community

* [X (Twitter)](https://x.com/ston_fi)
* [Telegram](https://t.me/stonfidex)
* [Discord](https://discord.com/invite/bdmaGV6qUw)
* [Reddit](https://www.reddit.com/r/Stonfiers)
* [LinkedIn](https://www.linkedin.com/company/ston-fi/)
* [YouTube](https://www.youtube.com/@stonfidex)
* [CoinMarketCap Community](https://coinmarketcap.com/community/profile/ston_fi/)
* [TikTok](https://www.tiktok.com/@ston.fi)
* [Instagram](https://www.instagram.com/stonfidefi)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ston.fi/getting-started/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
