Comment Omniston gère les frais de parrainage pour les intégrateurs
Omniston, le protocole d’agrégation de liquidité de TON, permet aux portefeuilles, interfaces de trading et bots de gagner des revenus sur les swaps qu’ils acheminent via lui. Les intégrateurs ajoutent une adresse de parrainage et un taux de frais à la demande de cotation ; Omniston intègre ces frais avant que les resolveurs ne se concurrencent, de sorte que le taux est verrouillé avant que le trader ne signe.
Post image
Mise en place
Deux champs transportent les frais : referrer_address (le portefeuille TON à rémunérer) et referrer_fee_bps, où 1 bps équivaut à 0,01 % — 10 bps correspondent à 0,1 %, 50 bps à 0,5 %. Les SDK utilisent referrerAddress/referrerFeeBps ; le Widget reprend ces champs.
De la cotation au règlement
1. Le trader choisit les actifs et le montant.
2. L’application demande une cotation avec les données de parrainage jointes.
3. Les resolveurs se font concurrence, les frais sont déjà intégrés au prix.
4. Le trader signe la cotation gagnante.
5. La source de liquidité gagnante règle les frais.
Pourquoi le routage compte
DEX v1 verse instantanément un 0,1 % fixe dans le swap. DEX v2 prend en charge 0,01 %–1 %, mais les frais s’accumulent dans des coffres par jeton, réclamés manuellement ou via le SDK. DeDust, Tonco et CoffeeSwap paient instantanément en TON, mais conservent les frais en jettons dans des coffres séparés nécessitant des appels on chain. Escrow utilise entièrement ses propres contrats de coffre distincts.
Frais flexibles
flexible_referrer_fee, désactivé par défaut, permet à Omniston de diminuer, jamais d’augmenter, vos frais afin qu’un routage v1 mieux tarifé puisse quand même l’emporter lorsque le taux demandé dépasse le plafond de 10 bps de v1.
Suivi des revenus
Les soldes des portefeuilles seuls ne prennent pas en compte les frais conservés dans les coffres. L’API de STON.fi couvre uniquement les coffres DEX v2 ; les frais de DeDust, Tonco, CoffeeSwap et Escrow nécessitent des vérifications on chain ou un indexage personnalisé jusqu’à l’arrivée d’une API unifiée.
Le vrai choix
Un taux strict offre des revenus prévisibles, mais peut exclure le meilleur routage v1. Les frais flexibles protègent la qualité d’exécution tout en payant quand même le maximum du routage. Taux strict ou frais flexibles : qu’est-ce qui sert le mieux vos utilisateurs ?
#BTC $BTC $BASE
Omniston, le protocole d’agrégation de liquidité de TON, permet aux portefeuilles, interfaces de trading et bots de gagner des revenus sur les swaps qu’ils acheminent via lui. Les intégrateurs ajoutent une adresse de parrainage et un taux de frais à la demande de cotation ; Omniston intègre ces frais avant que les resolveurs ne se concurrencent, de sorte que le taux est verrouillé avant que le trader ne signe.
Post image
Mise en place
Deux champs transportent les frais : referrer_address (le portefeuille TON à rémunérer) et referrer_fee_bps, où 1 bps équivaut à 0,01 % — 10 bps correspondent à 0,1 %, 50 bps à 0,5 %. Les SDK utilisent referrerAddress/referrerFeeBps ; le Widget reprend ces champs.
De la cotation au règlement
1. Le trader choisit les actifs et le montant.
2. L’application demande une cotation avec les données de parrainage jointes.
3. Les resolveurs se font concurrence, les frais sont déjà intégrés au prix.
4. Le trader signe la cotation gagnante.
5. La source de liquidité gagnante règle les frais.
Pourquoi le routage compte
DEX v1 verse instantanément un 0,1 % fixe dans le swap. DEX v2 prend en charge 0,01 %–1 %, mais les frais s’accumulent dans des coffres par jeton, réclamés manuellement ou via le SDK. DeDust, Tonco et CoffeeSwap paient instantanément en TON, mais conservent les frais en jettons dans des coffres séparés nécessitant des appels on chain. Escrow utilise entièrement ses propres contrats de coffre distincts.
Frais flexibles
flexible_referrer_fee, désactivé par défaut, permet à Omniston de diminuer, jamais d’augmenter, vos frais afin qu’un routage v1 mieux tarifé puisse quand même l’emporter lorsque le taux demandé dépasse le plafond de 10 bps de v1.
Suivi des revenus
Les soldes des portefeuilles seuls ne prennent pas en compte les frais conservés dans les coffres. L’API de STON.fi couvre uniquement les coffres DEX v2 ; les frais de DeDust, Tonco, CoffeeSwap et Escrow nécessitent des vérifications on chain ou un indexage personnalisé jusqu’à l’arrivée d’une API unifiée.
Le vrai choix
Un taux strict offre des revenus prévisibles, mais peut exclure le meilleur routage v1. Les frais flexibles protègent la qualité d’exécution tout en payant quand même le maximum du routage. Taux strict ou frais flexibles : qu’est-ce qui sert le mieux vos utilisateurs ?
#BTC $BTC $BASE
