> 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/reference.md). # Referencia de API Esta página proporciona una breve descripción general de todos los endpoints disponibles en la API DEX v1.168.0 de STON.fi. {% hint style="info" %} Para ver los parámetros detallados, los esquemas de solicitud/respuesta y las pruebas interactivas, consulta nuestros [Swagger UI](https://api.ston.fi/swagger-ui/) o [Redoc](https://api.ston.fi/redoc) visores. {% endhint %} **URL base:** `https://api.ston.fi` ## Operaciones DEX ### Simulación de swap `POST /v1/swap/simulate` - Simula un intercambio de tokens antes de su ejecución. Calcula la salida esperada, las comisiones y los costes de gas. ### Simulación de swap inverso `POST /v1/reverse_swap/simulate` - Calcula la cantidad de entrada necesaria para recibir una cantidad de salida específica. ### Simulación de provisión de liquidez `POST /v1/liquidity_provision/simulate` - Previsualiza la adición de liquidez con compatibilidad para los tipos de provisión Inicial, Equilibrada y Arbitraria. ### Estado del swap `GET /v1/swap/status` - Comprueba el estado de una operación de swap usando la dirección del router, la dirección del propietario y el ID de consulta. ### Árbol de acciones de transacción `POST /v1/transaction/action_tree` - Devuelve la lista aplanada de acciones y estados de STON.fi activados por una transacción de origen. ### Consulta de transacción `POST /v1/transaction/query` - Resuelve una transacción por `(wallet_address + query_id)` o `ext_msg_hash`; devuelve un TxId con `lt`, `hash`, y `contract_address`. ### Routers * `GET /v1/routers` - Lista todos los routers disponibles * `GET /v1/routers/{address}` - Obtiene los detalles de un router específico ### Mercados `GET /v1/markets` - Obtiene todos los pares de trading disponibles ## Activos ### Operaciones de activos * `GET /v1/assets` - Lista todos los activos disponibles * `GET /v1/assets/{address}` - Obtiene los detalles de un activo específico * `POST /v1/assets/query` - Consulta activos con condiciones (admite `search_term`, `sort_by`, y `limit` filters) * `POST /v1/assets/search` - Endpoint heredado de búsqueda de activos; se prefiere `POST /v1/assets/query` ### Operaciones Jetton `GET /v1/jetton/{address}/address` - Obtiene la dirección de la billetera jetton para un propietario específico ## Pools ### Operaciones de pools * `GET /v1/pools` - Lista todos los pools de liquidez * `GET /v1/pools/{address}` - Obtiene los detalles de un pool específico * `GET /v1/pools/by_market/{asset0}/{asset1}` - Obtiene los pools de un par de tokens * `POST /v1/pools/query` - Consulta pools con condiciones (admite `search_term`, `sort_by`, y `limit`; `/v1/pool/query` se mantiene por compatibilidad hacia atrás) ## Farms ### Operaciones de farm * `GET /v1/farms` - Lista todas las farms * `GET /v1/farms/{address}` - Obtiene los detalles de una farm específica * `GET /v1/farms/by_pool/{pool_address}` - Obtiene farms por pool ## Billeteras ### Datos específicos de la billetera * `GET /v1/wallets/{address}/assets` - Obtiene los activos de la billetera * `GET /v1/wallets/{address}/assets/{asset}` - Obtiene un activo específico en la billetera * `GET /v1/wallets/{address}/pools` - Obtiene las posiciones de liquidez de la billetera * `GET /v1/wallets/{address}/pools/{pool}` - Obtiene una posición específica del pool * `GET /v1/wallets/{address}/farms` - Obtiene las posiciones de farm de la billetera * `GET /v1/wallets/{address}/farms/{farm}` - Obtiene una posición específica de farm * `GET /v1/wallets/{address}/stake` - Obtiene las posiciones de staking de la billetera * `GET /v1/wallets/{address}/operations` - Obtiene el historial de transacciones de la billetera * `GET /v1/wallets/{address}/transactions/last` - Obtiene las transacciones más recientes de una billetera * `GET /v1/wallets/{address}/fee_vaults` - Lista los vaults de comisiones de referidos para **STON.fi DEX v2** para la billetera dada (`referrer × token` ). Los pools de DEX v1 no usan vaults, por lo que las comisiones de referidos de v1 no aparecerán aquí. ## Estadísticas ### Estadísticas del protocolo * `GET /v1/stats/dex` - Estadísticas generales del DEX (TVL, volumen, usuarios, operaciones) * `GET /v1/stats/pool` - Estadísticas de pools para un período de tiempo * `GET /v1/stats/stake` - Estadísticas de staking para un período de tiempo * `GET /v1/stats/operations` - Estadísticas de operaciones de trading ### Estadísticas de comisiones * `GET /v1/stats/fees` - Estadísticas agregadas de comisiones de referidos (p. ej., importe total acumulado / valor en USD) durante un período de tiempo. * `GET /v1/stats/fee_accruals` - Historial detallado de acumulación de comisiones de referidos para **vaults de comisiones de referidos de STON.fi DEX v2**. Este endpoint se construye a partir de operaciones de vault (filtradas por propietario y rango de tiempo), por lo que **no** incluye las comisiones de referidos de DEX v1 pagadas directamente a direcciones de billetera. * `GET /v1/stats/fee_withdrawals` - Operaciones de retiro desde **STON.fi DEX v2** vaults de comisiones de referidos. DEX v1 no usa vaults, por lo que no hay entradas de v1 aquí. > **Nota:** Estos endpoints solo cubren la actividad de referidos en los pools del DEX STON.fi. Las rutas de Omniston que se ejecutan en DEX externos como DeDust o Tonco aún no están expuestas a través de la API de estadísticas del DEX. ## Exportación ### Integraciones de terceros * `GET /export/cmc/v1` - Exporta datos en formato CoinMarketCap * `GET /export/dexscreener/v1/latest-block` - Último bloque indexado * `GET /export/dexscreener/v1/asset/{address}` - Información del activo para DexScreener * `GET /export/dexscreener/v1/pair/{address}` - Información del pool para DexScreener * `GET /export/dexscreener/v1/events` - Flujo de eventos para un rango de bloques ## Parámetros comunes ### Parámetros de consulta * **Rangos de tiempo:** Usa el formato `YYYY-MM-DDTHH:MM:SS` * **Direcciones:** Direcciones de la blockchain TON (por ejemplo, `EQBynBO23ywHy_CgarY9NK9FTz0yDsG82PtcbSTQgGoXwiuA`) * **Importes:** Valores de cadena en las unidades más pequeñas (1 TON = "1000000000") * **Slippage:** Valores decimales (0.001 = 0.1%) ### Filtros * `dex_v2`: Booleano para filtrar pools/routers V2 (predeterminado: true) * `only_active`: Muestra solo farms activas * `op_type`: Filtra operaciones por tipo (swap, provide\_liquidity, etc.) ## Límites de velocidad Actualmente, no hay límites de velocidad para la API del DEX. ## SDK Para facilitar la integración, usa nuestro [SDK de TypeScript](https://github.com/ston-fi/api): ```bash npm install @ston-fi/api ``` ```typescript import { DEX } from '@ston-fi/api'; const dex = new DEX(); const assets = await dex.getAssets(); ``` ## Soporte Para obtener la información más actualizada sobre parámetros, formatos de respuesta y nuevos endpoints, consulta siempre nuestro [Swagger UI](https://api.ston.fi/swagger-ui/) o [Redoc](https://api.ston.fi/redoc). --- # 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/reference.md?ask= ``` 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.