Twin Documentation
  • Overview
  • Consumer
  • Developer
  • Operations
Arquitectura
Flujos Técnicos
    Minting & RedeemBridge Cross-chainUniswap V4 Liquidity ManagementOracle Price UpdatesAuto-RebalanceRewardsAuthentication (Platform)Circulation ManagementDisperse (Batch Transfer)Market Data PipelineSupply API (CoinGecko)Contract Data CollectionCron Jobs: Flujos Detallados
Base de Datos
Local SetupConventions
powered by Zudoku
Flujos Técnicos

Market Data Pipeline

Overview

El servicio DuneMarketDataService agrega datos de mercado de múltiples fuentes para la página Explore de la platform. Implementa cache de 10 minutos.

Fuentes de datos

Flujo detallado

Total Supply (USD)

Code
Por cada token en la query de Dune: 1. Obtener total_supply (en units del token) 2. Buscar precio Belo del par (ej: USDC/ARGt → ~1466) 3. USD value = totalSupply / beloRate Total Supply USD = Σ(USD value de cada token)

TVL (on-chain)

Code
Por cada UniswapWallet activa con posición: 1. Leer sqrtPriceX96 del pool → currentPrice 2. Leer posición (liquidity, tickLower, tickUpper) 3. Calcular amount0, amount1 de la posición Si token0 es stablecoin: TVL = amount0 + amount1 / currentPrice Si token1 es stablecoin: TVL = amount0 × currentPrice + amount1

Fallback

Si algún fetch falla, Promise.allSettled permite continuar con los demás. Si todos fallan, retorna el cache stale (si existe) o valores en cero.

Precios Belo

El servicio parsea pares con el formato USDC/ARGt, USDC/BRAt, etc. El precio es el midpoint: (ask + bid) / 2.

Tokens soportados: ARGt, BRAt, COLt, MEXt, CHLt, BOLt.

Last modified on April 29, 2026
Disperse (Batch Transfer)Supply API (CoinGecko)
On this page
  • Overview
  • Fuentes de datos
  • Flujo detallado
  • Total Supply (USD)
  • TVL (on-chain)
  • Fallback
  • Precios Belo