Referencia de la API

Referencia de la API del DEX de STON.fi: endpoints REST para pools, swaps, liquidez y datos de mercado

Esta página proporciona una breve descripción general de todos los endpoints disponibles en la API DEX v1.168.0 de STON.fi.

Para ver los parámetros detallados, los esquemas de solicitud/respuesta y las pruebas interactivas, consulta nuestros Swagger UI o Redoc visores.

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:

npm install @ston-fi/api

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 o Redoc.