# v1 SDK

The remaining sections of the documentation will demonstrate specific examples of the DEX usage:

* [methods reference](/developer-section/dex/sdk/v1/reference.md)
* [perform a swap operation](/developer-section/dex/sdk/v1/swap.md)
* [provide liquidity](/developer-section/dex/sdk/v1/provide-liquidity.md)
* [refund liquidity](/developer-section/dex/sdk/v1/refund-liquidity.md)
* [burn liquidity tokens](/developer-section/dex/sdk/v1/burn-lp-tokens.md)

## Referral Fees

DEX v1 pays the referrer fee directly inside each swap transaction. The rate is fixed at **0.1 %** and the specified `referrer_address` receives the tokens immediately.

Track payouts using the Stats & Vaults REST API:

* `GET /v1/stats/fee_accruals` – shows all operations leading to fee accrual for the referrer, filterable by period
* `GET /v1/stats/fee_withdrawals` – lists withdrawals from the referrer's vaults by period
* `GET /v1/stats/fees` – returns aggregated referral fee information such as total accrued USD value

See the [Omniston referral fees guide](/developer-section/omniston/referral-fees.md#referral-fees-with-dex-v1) (remember: although the guide focuses on Omniston, the linked paragraph explains DEX V1 referral fees in detail). Full API docs are available in the [Swagger UI](https://api.ston.fi/swagger-ui/#/).


---

# 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/dex/sdk/v1.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.
