> 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/es/seccion-para-desarrolladores/dex/api.md).

# API REST

Junto con los contratos, ofrecemos una API REST para simplificar las interacciones con el protocolo STON.fi.

La API de DEX proporciona datos de los contratos de STON.fi a lo largo del tiempo y organiza datos sobre pools, jettons, el protocolo STON.fi en su conjunto y más.

{% hint style="info" %}
La API de DEX está aquí en vivo [api.ston.fi](https://api.ston.fi)
{% endhint %}

### Límites

Actualmente, no hay límites para el uso de la API de DEX.

### Visores de API

Puede explorar el esquema completo y probar solicitudes a través de:

* [Swagger UI](https://api.ston.fi/swagger-ui/)
* [Redoc](https://api.ston.fi/redoc)

### SDK

Para simplificar la integración de la API de DEX en sus proyectos, también contamos con un pequeño [paquete SDK de TypeScript](https://github.com/ston-fi/api)

### Referencia de la API

Para una lista completa de todos los endpoints disponibles con breves descripciones, consulte nuestra [Referencia de la API](/es/seccion-para-desarrolladores/dex/api/reference.md).

### Endpoints de comisión de referidos

Si usa comisiones de referido de Omniston con pools de STON.fi, la API de DEX expone varios endpoints de ayuda:

* **Bóvedas a nivel de wallet:** `GET /v1/wallets/{address}/fee_vaults` Enumera las bóvedas de comisiones de referido para **STON.fi DEX v2** para un referido dado.
* **Estadísticas de comisiones:**
  * `GET /v1/stats/fee_accruals` – Acumulaciones de comisiones de referido por swap para **DEX v1 y v2** (para v1, las acumulaciones se pagan instantáneamente al referido; las acumulaciones de v2 van a las bóvedas de comisiones)
  * `GET /v1/stats/fee_withdrawals` – Retiros de **DEX v2** bóvedas
  * `GET /v1/stats/fees` – Estadísticas agregadas de comisiones de referido

Estos endpoints solo cubren pools de STON.fi DEX v1/v2. Las comisiones de referido a nivel de Omniston para DEX externos como **DeDust** y **Tonco** aún no están disponibles a través de REST y deben rastrearse en la cadena.

Para una descripción completa de cómo se calculan y liquidan las comisiones de referido en DEX v1, DEX v2, DeDust y Tonco, consulte la guía [Comisiones de referidos en Omniston](/es/seccion-para-desarrolladores/omniston/referral-fees.md) .


---

# 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 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/es/seccion-para-desarrolladores/dex/api.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.