API (Markup)

Author profile photo
Équipe Quickex
10 novembre 2025
~3 lecture minimale

Monétisation via API (Markup)

Taux majoré contrôlé par le partenaire. Revenus flexibles grâce à l’intégration API.

Rémunérations B2B
Frais de plateforme — 0.5–2% (inclus dans le taux)
Markup — marge partenaire (incluse dans le taux)
Commission de parrainage — à partir des frais de plateforme (n’affecte pas le taux)
Quand appliqué
  • Lors du calcul du taux (aperçu)
  • Lors de la création de l’ordre (montants finaux)
  • Lors des paiements au partenaire
Endpoints API
  • GET /api/v1/rates/public/one
  • POST /api/v2/orders/public/create

Que voit l’utilisateur et combien gagne le partenaire ?

Si le taux Quickex BTC → USDT est de 100,000 et que le partenaire définit un markup = 0.5%, l’utilisateur suivant le lien du partenaire recevra ~99,500, et la différence de 500 sera perçue par le partenaire comme revenu de markup. En plus, le partenaire peut recevoir une commission de parrainage à partir des frais de plateforme.

Fonctionnement du calcul avec Markup

Les frais de plateforme et le Markup affectent le taux ; la commission de parrainage non.

Calcul préliminaire du taux
A_final = A_calculated × (1 − (K_markup / 100))
Paramètre Description
A_final Montant final à recevoir (prévision)
A_calculated Montant avant application du markup
K_markup Pourcentage de markup
Exemple : 49549.728 × (1 − 0.3/100) = 49401.078
Versement final au client (création de l’ordre)
A_withdrawal = A_exchange × (1 − ((C_platform + K_markup) / 100))
Paiement au partenaire (après COMPLETED)
C_affiliate = (C_platform × C_affiliate_percent / 100) + (C_platform × K_markup / 100)

Récupérer le taux (avec markup appliqué)

Endpoint sans authentification et sans liste blanche d’IP.

Request
GET /api/v1/rates/public/one?instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&rateMode=FLOATING&claimedDepositAmount=1&markup=0.3
Extrait de réponse
{
  "instrumentFrom": { "currencyTitle": "BTC", "networkTitle": "BTC" },
  "instrumentTo":   { "currencyTitle": "USDT","networkTitle": "TRC20" },
  "amountToGive": "1",
  "amountToGet":  "50201.90689595",
  "markup": "0.3"
}
Paramètres de la requête
Paramètre Description Exemple
instrumentFromCurrencyTitle Devise source BTC
instrumentFromNetworkTitle Réseau de la devise source BTC
instrumentToCurrencyTitle Devise cible USDT
instrumentToNetworkTitle Réseau de la devise cible TRC20
rateMode FLOATING / FIXED FLOATING
claimedDepositAmount Montant du dépôt 1
markup Pourcentage de markup 0.3

Créer un ordre avec markup

Transmettez le champ markup dans le corps de la requête.

Request
POST /api/v2/orders/public/create
Content-Type: application/json
{
"rateMode": "FLOATING",
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo":   { "currencyTitle": "BTC",  "networkTitle": "BTC"    },
"destinationAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"claimedDepositAmount": "125000",
"markup": "0.2",
"browserFingerprint": "6b3add86bec11616427d069556a33548"
}

Exemple complet de calcul

Exemple XMR (Frais de plateforme → Markup → Frais réseau), paiements partenaires et valeurs en USDT.

JSON source
{
  "platformFee": { "selectedPlatformFee": 0.5 },
  "networkFee":  { "calculatedNetworkFee": 0.002 },
  "calcAmountToWithdraw": {
    "claimedAmountToReceive": 2.9355,
    "markup": 1.65,
    "orderPlatformFeeAbsoluteAmount": 0.014761061416,
    "amountToWithdrawWithoutNetworkFee": 2.983438938584,
    "amountToWithdraw": 2.932212196097364
  },
  "performWithdrawal": {
    "finalAmountToWithdraw": 2.93221219,
    "amountToWithdrawFactUSDT": 976.6319141233
  }
}

Valeurs clés
Paramètre Valeur Description
fundingAvailableBalance 2.9982 XMR Solde avant retrait
orderPlatformFeeAbsoluteAmount 0.014761061416 XMR Frais de plateforme (0.5%)
markup 1.65% Markup du partenaire
networkFee.actualNetworkFee 0.002 XMR Frais réseau
performWithdrawal.amountToWithdrawFact 2.93221219 XMR Montant final à retirer
performWithdrawal.amountToWithdrawFactUSDT 976.6319 USDT Montant final en USDT

Étapes :
  1. Soustraire les frais de plateforme : 2.9982 − 0.014761061416 = 2.983438938584 XMR
  2. Appliquer 1.65% de markup : 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
  3. Soustraire les frais réseau : 2.9342122 − 0.002 = 2.932212196097364 XMR
Le client reçoit : 2.93221219 XMR ≈ 976.63 USDT

Paiement au partenaire
ReferralReward = PlatformFee × (Affiliate%/100) = 0.007380973823 XMR (à 50%)
PartnerMarkup = FinalXMR × (markup/100) = 0.048381501135 XMR

Total pour le partenaire : 0.055770474958 XMR
Paiement en USDT
PartnerTotalUSDT = PartnerTotalXMR × Rate = 0.055770474958 × 333.12 ≈ 18.5444 USDT

Mécanisme de Markup par paliers (ladder)

Règles basées sur le volume : pourcentages différents et option d’inclure les frais réseau.

Configuration (concept)
[
  { "amountFromUSDT": 0,    "floating%": 0.5, "fixed%": 2.0, "includeNetworkFees": true  },
  { "amountFromUSDT": 9000, "floating%": 0.5, "fixed%": 2.0, "includeNetworkFees": true  },
  { "amountFromUSDT": 30000,"floating%": 0.3, "fixed%": 1.5, "includeNetworkFees": false }
]
Logique de sélection du palier
  1. Prendre claimedDepositAmount depuis la requête
  2. Trouver le dernier palier où Amount from ≤ claimedDepositAmount
  3. Utiliser ses pourcentages (pour le calcul et le simulateur)
Exemple : pour claimedDepositAmount = 9000, choisir le palier « à partir de 9000 » ; taux fixe — 2%, flottant — 0.5%.

Comment devenir partenaire et recevoir des paiements

  1. S’inscrire sur Quickex et ouvrir la section Programme Partenaire (aff-ID) dans votre compte
  2. Pour définir un markup, contacter le support (la demande est transmise au marketing)
  3. Intégrer le widget / l’API et utiliser le paramètre markup
  • Demande de paiement via le compte
  • Montant minimum : 100 USDT
  • Réseau de paiement : USDT TRC20 (par défaut)

Bonnes pratiques
  • Éviter un markup excessif — cela nuit à la conversion
  • Tester les paliers « ladder » en fonction des volumes
  • Afficher le taux final à l’utilisateur (transparence)
Important
La commission de parrainage est calculée à partir des frais de plateforme et ne participe pas au calcul du taux.
Anti-patterns
  • Frais cachés dans l’interface
  • Incohérence des valeurs de paliers « ladder » entre le moteur de calcul et le calculateur
  • Oublier de transmettre markup lors de la création d’un ordre
Partagez cet article :