games_app/docs/PREDICTION-HOUSE-EDGE-CONFIG.md

13 KiB
Raw Blame History

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