334 lines
13 KiB
Markdown
334 lines
13 KiB
Markdown
# Configuration marge plateforme (prédictions Candle Predict)
|
||
|
||
Guide pour calibrer les règles de round (gagnant du pool, neutres, Daily revenue) afin de **conserver une marge nette** après les **commissions de parrainage**, destinée à la maintenance et à l’hébergement.
|
||
|
||
Où configurer : **Admin → Catalog** (Candle Predict) + **Admin → Referral** (niveaux de commission).
|
||
|
||
---
|
||
|
||
## Hypothèses économiques
|
||
|
||
| Paramètre | Valeur retenue dans ce guide |
|
||
|-----------|------------------------------|
|
||
| Commissions prédiction (somme de tous les niveaux) | **15 %** de la mise |
|
||
| Quand la commission est payée | Settle **gagné** ou **perdu** uniquement |
|
||
| Quand elle n’est **pas** payée | Round **neutre** (remboursement) |
|
||
| Multiplicateur de payout (défaut) | **1,9×** (`payout_multiplier`) |
|
||
| Objectifs traités ici | **+10 % nets** ou **+5 % nets** par volume de mises non neutres |
|
||
|
||
### Formule de base
|
||
|
||
Marge **jeu** (avant commissions), sur un round non neutre :
|
||
|
||
\[
|
||
H = 1 - M \times w
|
||
\]
|
||
|
||
- \(M\) = multiplicateur de payout (ex. 1,9)
|
||
- \(w\) = part des mises du **côté gagnant** / total des mises du round
|
||
|
||
Marge **nette** plateforme (si toute la volume est commissionnée à 15 %) :
|
||
|
||
\[
|
||
\text{Net} \approx H - 0{,}15
|
||
\]
|
||
|
||
| Objectif net | Marge jeu minimale \(H\) requise |
|
||
|-------------|----------------------------------|
|
||
| **+10 %** | **≥ 25 %** |
|
||
| **+5 %** | **≥ 20 %** |
|
||
|
||
Avec \(M = 1{,}9\) :
|
||
|
||
| Objectif net | Part max du côté gagnant \(w\) | Écart min entre pools |
|
||
|--------------|--------------------------------|------------------------|
|
||
| **+10 %** | ≲ **39,5 %** | ≳ **~21 points** (ex. ≥ 60,5 / 39,5) |
|
||
| **+5 %** | ≲ **42,1 %** | ≳ **~16 points** (ex. ≥ 58 / 42) |
|
||
|
||
> **Important :** le champ **Daily revenue target** cumule le **PnL jeu uniquement** (mises − payouts). Il **ne déduit pas** les 15 % de commissions. Pour un objectif net réel, la cible journalière doit être calée sur \(H\) (25 % ou 20 % du volume), pas sur le net seul.
|
||
|
||
---
|
||
|
||
## Deux modes de gagnant du pool
|
||
|
||
### A. Minority pool wins (smaller total stake)
|
||
|
||
- Le **plus petit** pool gagne toujours (hors neutre).
|
||
- Permet de viser une marge **par round non neutre** en **filtrant** les rounds trop serrés via **min tolerance**.
|
||
- Recommandé si l’objectif est « **chaque** round non neutre ≥ X % nets ».
|
||
|
||
### B. Daily revenue target (random + financial gate)
|
||
|
||
- Neutres min/max d’abord, puis hasard Long/Short.
|
||
- Si le hasard donne la **majorité** et que payer cette majorité ferait passer le PnL du jour **sous** la cible → stratégie overflow :
|
||
- **Make the minority win**, ou
|
||
- **Declare a neutral round (refund)**.
|
||
- Si après le round le PnL reste **≥ cible**, la majorité **peut** gagner (elle peut grignoter le surplus au-dessus du plancher, pas descendre sous la cible).
|
||
- Protège surtout le **cumul UTC du jour**, **pas** chaque round individuellement.
|
||
|
||
---
|
||
|
||
## Règles de neutralité (min / max)
|
||
|
||
| Règle | Effet | 50/50 exact |
|
||
|-------|--------|-------------|
|
||
| **Min tolerance** | Neutre si \|Long% − Short%\| ≤ seuil | Toujours neutre, même si min est OFF |
|
||
| **Max tolerance** | Neutre si le plus gros pool ≥ seuil (ex. 95/5, solo 100 %) | — |
|
||
|
||
- **Min ON** : filet « pools trop proches ».
|
||
- **Max ON** : filet « extrême / solo » (remboursement).
|
||
- **Max OFF** : les rounds extrêmes se jouent ; en **Minority**, souvent très favorables à la plateforme (la petite side gagne) ; UX plus dure pour un joueur solo.
|
||
|
||
---
|
||
|
||
## Configuration pour **+10 % nets** (commissions 15 %)
|
||
|
||
Marge jeu cible : **25 %**.
|
||
|
||
### Option 1 — Minority (garantie par round non neutre)
|
||
|
||
| Paramètre | Valeur |
|
||
|-----------|--------|
|
||
| Pool winner rule | **Minority pool wins** |
|
||
| Payout multiplier | **1,90** (ou voir table ci-dessous) |
|
||
| Enable min tolerance | **ON** |
|
||
| Min tolerance (%) | **21** (plage 20–22) |
|
||
| Enable max tolerance | **ON** (recommandé) |
|
||
| Max tolerance (%) | **95** |
|
||
|
||
Effet : seuls les rounds assez déséquilibrés (écart ≳ 21 %) se jouent ; la minorité gagne ; net ≈ ≥ 10 % après 15 % de commissions (volume pleinement commissionné).
|
||
|
||
Si vous baissez le multiplicateur :
|
||
|
||
| Payout \(M\) | Min tolerance ≈ (objectif +10 % nets) |
|
||
|--------------|----------------------------------------|
|
||
| 1,90 | **21 %** |
|
||
| 1,85 | **19 %** |
|
||
| 1,80 | **17 %** |
|
||
| 1,70 | **12 %** |
|
||
|
||
### Option 2 — Daily revenue (plancher journalier)
|
||
|
||
| Paramètre | Valeur |
|
||
|-----------|--------|
|
||
| Pool winner rule | **Daily revenue target** |
|
||
| Overflow | **Make the minority win** |
|
||
| Daily revenue target | **`0,25 × volume moyen quotidien (USDT)`** |
|
||
| Min tolerance | **ON → 2 %** (filet classique, pas le filtre 21 %) |
|
||
| Max tolerance | **ON → 95 %** |
|
||
| Payout multiplier | **1,85–1,90** |
|
||
|
||
#### Cible USDT/jour (10 % nets → plancher jeu 25 %)
|
||
|
||
| Volume moyen / jour | `dailyRevenueTarget` |
|
||
|---------------------|----------------------|
|
||
| 200 USDT | **50** |
|
||
| 500 USDT | **125** |
|
||
| 1 000 USDT | **250** |
|
||
| 2 000 USDT | **500** |
|
||
| 5 000 USDT | **1 250** |
|
||
| 10 000 USDT | **2 500** |
|
||
|
||
Lire le volume : **Admin → Dashboard** (segments real main+bonus, hors test) sur 7 ou 30 jours, puis ÷ nombre de jours.
|
||
|
||
---
|
||
|
||
## Configuration pour **+5 % nets** (commissions 15 %)
|
||
|
||
Marge jeu cible : **20 %**.
|
||
|
||
### Option 1 — Minority (garantie par round non neutre)
|
||
|
||
| Paramètre | Valeur |
|
||
|-----------|--------|
|
||
| Pool winner rule | **Minority pool wins** |
|
||
| Payout multiplier | **1,90** |
|
||
| Enable min tolerance | **ON** |
|
||
| Min tolerance (%) | **16** (plage 15–17) |
|
||
| Enable max tolerance | **ON** (recommandé) |
|
||
| Max tolerance (%) | **95** |
|
||
|
||
| Payout \(M\) | Min tolerance ≈ (objectif +5 % nets) |
|
||
|--------------|--------------------------------------|
|
||
| 1,90 | **16 %** |
|
||
| 1,85 | **14 %** |
|
||
| 1,80 | **11 %** |
|
||
| 1,70 | **6 %** |
|
||
|
||
### Option 2 — Daily revenue (plancher journalier)
|
||
|
||
| Paramètre | Valeur |
|
||
|-----------|--------|
|
||
| Pool winner rule | **Daily revenue target** |
|
||
| Overflow | **Make the minority win** |
|
||
| Daily revenue target | **`0,20 × volume moyen quotidien (USDT)`** |
|
||
| Min tolerance | **ON → 2 %** |
|
||
| Max tolerance | **ON → 95 %** |
|
||
|
||
#### Cible USDT/jour (5 % nets → plancher jeu 20 %)
|
||
|
||
| Volume moyen / jour | `dailyRevenueTarget` |
|
||
|---------------------|----------------------|
|
||
| 200 USDT | **40** |
|
||
| 500 USDT | **100** |
|
||
| 1 000 USDT | **200** |
|
||
| 2 000 USDT | **400** |
|
||
| 5 000 USDT | **1 000** |
|
||
| 10 000 USDT | **2 000** |
|
||
|
||
---
|
||
|
||
## Tableau récapitulatif
|
||
|
||
| Objectif net | Mode | Min tolerance | Max tolerance | Daily target |
|
||
|--------------|------|---------------|---------------|--------------|
|
||
| **10 %** | Minority | **21 % ON** | **95 % ON** | n/a |
|
||
| **10 %** | Daily revenue | **2 % ON** | **95 % ON** | **0,25 × volume/jour** |
|
||
| **5 %** | Minority | **16 % ON** | **95 % ON** | n/a |
|
||
| **5 %** | Daily revenue | **2 % ON** | **95 % ON** | **0,20 × volume/jour** |
|
||
|
||
Overflow Daily revenue recommandé dans les deux cas : **Make the minority win** (plutôt que neutre), pour limiter les remboursements quand la majorité menacerait le plancher.
|
||
|
||
---
|
||
|
||
## Commissions (rappel)
|
||
|
||
- Configurer les **niveaux referral** pour que la somme des % prédiction ≈ **15 %**.
|
||
- Payées depuis le **bonus pool** plateforme, pas déduites du compteur Daily revenue.
|
||
- Joueurs sans parrain / chaîne courte / caps / Sybil → commission réelle parfois **< 15 %** (marge nette alors un peu meilleure que le modèle).
|
||
|
||
---
|
||
|
||
## Max tolerance OFF — que se passe-t-il ?
|
||
|
||
| | Max ON (95 %) | Max OFF |
|
||
|--|---------------|---------|
|
||
| Solo / 95/5 | Souvent **neutre** (refund) | Round **joué** |
|
||
| Minority | — | Très souvent **favorable** plateforme |
|
||
| Daily revenue (cible déjà OK) | Extrêmes souvent neutres | Un gros pool peut encore gagner si le PnL reste ≥ cible |
|
||
|
||
Désactiver max augmente la rentabilité potentielle en Minority, mais durcit l’expérience solo. Pour un objectif « chaque non-neutre ≥ X % », max OFF reste **compatible** (ces rounds dépassent largement X %) ; max ON est un choix **UX / prudence**.
|
||
|
||
---
|
||
|
||
## Multi-bougies (niveaux 2, 3, 4, 5)
|
||
|
||
Le multi **ne se calibre pas** comme le single (1,9× + part du pool gagnant).
|
||
La marge vient surtout du **taux d’échec de la séquence** : le joueur doit enchaîner **N** bonnes directions.
|
||
|
||
### Règles de settlement (rappel)
|
||
|
||
| Événement | Joueur | Marge jeu | Commission 15 % |
|
||
|-----------|--------|-----------|-----------------|
|
||
| Mauvaise direction (n’importe quelle étape) | Perd la mise | **+100 %** de la mise | Oui |
|
||
| Séquence complète gagnée | Crédit **M × mise** | **1 − M** | Oui |
|
||
| Neutre (n’importe quelle étape) | Remboursement total | **0 %** | Non |
|
||
| Bonne étape, pas la dernière | Mise toujours lockée | 0 pour l’instant | Non |
|
||
|
||
- `payout_multiplier` = gain si la séquence entière est correcte.
|
||
- `pool_multiplier` = poids dans le pool Long/Short **uniquement à la dernière bougie** (ne change pas le montant payé au gagnant).
|
||
- Où configurer : **Admin → Catalog** → niveaux multi-bougies.
|
||
|
||
### Hypothèse de calibration
|
||
|
||
- Environ **50 %** de chance de matcher la direction à chaque étape (surtout les étapes intermédiaires en mode auto).
|
||
- Commissions **15 %** sur chaque settle gagné/perdu.
|
||
- Marge nette cible : **Net ≈ 0,85 − M × (0,5)^N**.
|
||
|
||
Pour **+10 % nets** il faut \(H \ge 25\%\) ⇒ \(M \le 0{,}75 / (0{,}5)^N\).
|
||
Pour **+5 % nets** il faut \(H \ge 20\%\) ⇒ \(M \le 0{,}80 / (0{,}5)^N\).
|
||
|
||
### Défauts actuels (seed)
|
||
|
||
| Niveau | Bougies | Payout défaut | Pool défaut |
|
||
|--------|---------|---------------|-------------|
|
||
| 2 | 2 | **3×** | 3 |
|
||
| 3 | 3 | **6×** | 6 |
|
||
| 4 | 4 | **10×** | 10 |
|
||
| 5 | 5 | **15×** | 15 |
|
||
|
||
### Plafonds recommandés (fair ~50 % / étape)
|
||
|
||
| Niveau | Max \(M\) pour **≥ +10 % nets** | Max \(M\) pour **≥ +5 % nets** | Défaut | Lecture |
|
||
|--------|----------------------------------|----------------------------------|--------|---------|
|
||
| **2** | **≤ 3,0** | **≤ 3,2** | 3 | Juste à la limite +10 % |
|
||
| **3** | **≤ 6,0** | **≤ 6,4** | 6 | Juste à la limite +10 % |
|
||
| **4** | **≤ 12** | **≤ 12,8** | 10 | Confortable pour +10 % |
|
||
| **5** | **≤ 24** | **≤ 25,6** | 15 | Très confortable ; marge pour monter un peu |
|
||
|
||
### Valeurs concrètes recommandées
|
||
|
||
**Objectif sérieux +10 % nets :**
|
||
|
||
| Niveau | Payout recommandé | Pool (conseil) |
|
||
|--------|-------------------|----------------|
|
||
| 2 | **2,9** (plage 2,7–3,0) | ≈ payout |
|
||
| 3 | **5,8** (plage 5,5–6,0) | ≈ payout |
|
||
| 4 | **10** (plage 9–12) | ≈ payout |
|
||
| 5 | **15–18** (plafond dur 24) | ≈ payout |
|
||
|
||
**Objectif +5 % nets (un peu plus attractif marketing) :**
|
||
|
||
| Niveau | Payout recommandé | Pool (conseil) |
|
||
|--------|-------------------|----------------|
|
||
| 2 | **3,0–3,1** (≤ 3,2) | ≈ payout |
|
||
| 3 | **6,0** (≤ 6,4) | ≈ payout |
|
||
| 4 | **10–12** | ≈ payout |
|
||
| 5 | **15–20** | ≈ payout |
|
||
|
||
### Notes multi
|
||
|
||
1. Ne **pas** dépasser ~**3×** au niveau 2 si l’objectif dur est +10 % nets.
|
||
2. Les défauts **3 / 6 / 10 / 15** conviennent déjà pour ~+10 % aux niveaux 4–5 ; **baisser légèrement 2 et 3** donne un vrai coussin.
|
||
3. Si les joueurs battent clairement 50 % (skill / biais), les plafonds baissent : ex. à ~55 %/étape, niveau 2 ≈ **≤ 2,5×** pour +10 % nets.
|
||
4. Un neutre en cours de multi **rembourse toute la mise** → 0 marge, 0 commission.
|
||
5. Minority / Daily revenue influencent surtout la **dernière** bougie (et les maturités partagées avec des singles) ; ce n’est **pas** un substitut au calibrage de \(M\).
|
||
|
||
---
|
||
|
||
## Limites à connaître
|
||
|
||
1. **Aucun mode ne garantit +X % si le multiplicateur et les neutres ne sont pas calés** comme ci-dessus.
|
||
2. **Daily revenue** = plancher **jour**, pas round par round ; des rounds majorité au-dessus de la cible peuvent réduire le surplus.
|
||
3. Rounds **neutres** : 0 % marge jeu, **0 %** commission.
|
||
4. **Multi-bougies** : calibrer via la section dédiée (edge = échec de séquence, pas \(1 - M \cdot w\)).
|
||
5. Le modèle « Net = H − 15 % » suppose un volume **pleinement** commissionné à 15 %.
|
||
|
||
---
|
||
|
||
## Checklist rapide
|
||
|
||
**Pour +10 % nets, Minority :**
|
||
|
||
1. Pool winner = Minority
|
||
2. Min = **21 %** ON
|
||
3. Max = **95 %** ON
|
||
4. Commissions niveaux Σ = **15 %**
|
||
5. Payout single ≈ **1,9**
|
||
6. Multi payouts ≈ **2,9 / 5,8 / 10 / 15–18**
|
||
|
||
**Pour +5 % nets, Minority :**
|
||
|
||
1. Idem avec Min = **16 %** ON
|
||
2. Multi payouts ≈ **3,0–3,1 / 6,0 / 10–12 / 15–20**
|
||
|
||
**Pour Daily revenue :**
|
||
|
||
1. Overflow = Minority win
|
||
2. Target = **0,25 × volume** (10 %) ou **0,20 × volume** (5 %)
|
||
3. Min **2 %** / Max **95 %** ON
|
||
4. Recalculer la cible quand le volume moyen change
|
||
5. Même calibrage multi que ci-dessus
|
||
|
||
---
|
||
|
||
## Références code
|
||
|
||
- Settlement / PnL jour : `backend/src/domain/candle-predict/index.ts`
|
||
- Daily revenue + overflow : `backend/src/services/dailyRevenueOutcomeService.ts`
|
||
- Neutres min/max : `backend/src/services/candleGenerationService.ts` (`resolvePoolNeutrality`)
|
||
- Commissions prédiction : `backend/src/services/referralService.ts` (`processPredictionReferralCommissions`)
|
||
- Multi settlement : `backend/src/services/candlePredictMultiService.ts`
|
||
- UI admin : `prediqo_web/src/features/catalog/CandlePredictConfigPanel.tsx`
|
||
- UI multi levels : `prediqo_web/src/features/catalog/CandlePredictMultiLevelsPanel.tsx`
|