API (Markup)

Author profile photo
Team Quickex
10. November 2025
~3 Mindestlesezeit

Monetarisierung über API (Markup)

Vom Partner gesteuerter Aufschlag auf den Kurs. Flexible Einnahmen durch API-Integration.

B2B-Abrechnungen
Plattformgebühr — 0.5–2% (im Kurs enthalten)
Markup — Partner-Markup (im Kurs enthalten)
Referral-Vergütung — aus der Plattformgebühr (beeinflusst den Kurs nicht)
Wann angewendet
  • Bei der Kursberechnung (Vorschau)
  • Bei der Auftragserstellung (Endbeträge)
  • Bei Partnerauszahlungen
API-Endpunkte
  • GET /api/v1/rates/public/one
  • POST /api/v2/orders/public/create

Was sieht der Nutzer und was verdient der Partner?

Wenn der Quickex-Kurs BTC → USDT 100,000 beträgt und der Partner markup = 0.5% festlegt, erhält ein Nutzer, der dem Partnerlink folgt, ca. 99,500, und die Differenz von 500 wird als Markup-Einnahme vom Partner einbehalten. Zusätzlich kann der Partner eine Referral-Auszahlung aus der Plattformgebühr erhalten.

Wie die Berechnung mit Markup funktioniert

Plattformgebühr und Markup beeinflussen den Kurs; die Referral-Vergütung nicht.

Vorläufige Kursberechnung
A_final = A_calculated × (1 − (K_markup / 100))
Parameter Beschreibung
A_final Endbetrag zur Auszahlung (prognostiziert)
A_calculated Betrag vor Anwendung des markup
K_markup Markup-Prozentsatz
Beispiel: 49549.728 × (1 − 0.3/100) = 49401.078
Endgültige Auszahlung an den Kunden (Auftragserstellung)
A_withdrawal = A_exchange × (1 − ((C_platform + K_markup) / 100))
Partnerauszahlung (nach COMPLETED)
C_affiliate = (C_platform × C_affiliate_percent / 100) + (C_platform × K_markup / 100)

Abrufen des Kurses (mit angewendetem markup)

Endpoint ohne Authentifizierung und ohne IP-Whitelist.

Request
GET /api/v1/rates/public/one?instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&rateMode=FLOATING&claimedDepositAmount=1&markup=0.3
Antwort-Ausschnitt
{
  "instrumentFrom": { "currencyTitle": "BTC", "networkTitle": "BTC" },
  "instrumentTo":   { "currencyTitle": "USDT","networkTitle": "TRC20" },
  "amountToGive": "1",
  "amountToGet":  "50201.90689595",
  "markup": "0.3"
}
Request-Parameter
Parameter Beschreibung Beispiel
instrumentFromCurrencyTitle Quellwährung BTC
instrumentFromNetworkTitle Netzwerk der Quellwährung BTC
instrumentToCurrencyTitle Zielwährung USDT
instrumentToNetworkTitle Netzwerk der Zielwährung TRC20
rateMode FLOATING / FIXED FLOATING
claimedDepositAmount Einzahlungsbetrag 1
markup Markup-Prozentsatz 0.3

Erstellen einer Order mit markup

Das Feld markup im Request-Body übergeben.

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"
}

Vollständiges Berechnungsbeispiel

XMR-Beispiel (Plattformgebühr → Markup → Netzwerkgebühr), Partnerauszahlungen und Werte in USDT.

Quell-JSON
{
  "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
  }
}

Schlüsselwerte
Parameter Wert Beschreibung
fundingAvailableBalance 2.9982 XMR Kontostand vor Auszahlung
orderPlatformFeeAbsoluteAmount 0.014761061416 XMR Plattformgebühr (0.5%)
markup 1.65% Partner-Markup
networkFee.actualNetworkFee 0.002 XMR Netzwerkgebühr
performWithdrawal.amountToWithdrawFact 2.93221219 XMR Endbetrag zur Auszahlung
performWithdrawal.amountToWithdrawFactUSDT 976.6319 USDT Endbetrag in USDT

Schritte:
  1. Plattformgebühr abziehen: 2.9982 − 0.014761061416 = 2.983438938584 XMR
  2. 1.65% Markup anwenden: 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
  3. Netzwerkgebühr abziehen: 2.9342122 − 0.002 = 2.932212196097364 XMR
Kunde erhält: 2.93221219 XMR ≈ 976.63 USDT

Partnerauszahlung
ReferralReward = PlatformFee × (Affiliate%/100) = 0.007380973823 XMR (bei 50%)
PartnerMarkup = FinalXMR × (markup/100) = 0.048381501135 XMR

Gesamt an Partner: 0.055770474958 XMR
Auszahlung in USDT
PartnerTotalUSDT = PartnerTotalXMR × Rate = 0.055770474958 × 333.12 ≈ 18.5444 USDT

Gestaffelter (Ladder-)Mechanismus für Markup

Volumenbasierte Tiers: unterschiedliche Prozentsätze und Option zur Berücksichtigung von Netzwerkgebühren.

Konfiguration (Konzept)
[
  { "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 }
]
Tier-Auswahllogik
  1. claimedDepositAmount aus der Request nehmen
  2. Das letzte Tier finden, bei dem Amount from ≤ claimedDepositAmount
  3. Dessen Prozentsätze verwenden (für Berechnung und Rechner)
Beispiel: für claimedDepositAmount = 9000 das Tier „ab 9000“ wählen; Fixed — 2%, Floating — 0.5%.

Wie man Partner wird und Auszahlungen erhält

  1. Bei Quickex registrieren und den Bereich Partnerprogramm (aff-ID) im Account öffnen
  2. Um ein Markup festzulegen, den Support kontaktieren (Anfrage geht an Marketing)
  3. Widget/API integrieren und den Parameter markup nutzen
  • Auszahlungsanfrage über das Konto
  • Mindestbetrag: 100 USDT
  • Auszahlungsnetzwerk: USDT TRC20 (Standard)

Best Practices
  • Übermäßiges markup vermeiden — das verschlechtert die Conversion
  • Gestaffelte („Ladder“-)Tiers nach Volumen testen
  • Dem Nutzer den endgültigen Kurs anzeigen (Transparenz)
Wichtig
Die Referral-Vergütung wird aus der Plattformgebühr berechnet und fließt nicht in die Kursberechnung ein.
Anti-Pattern
  • Versteckte Gebühren im UI
  • Inkonsistente „Ladder“-Tier-Werte zwischen Berechnungen und Rechner
  • Vergessen, markup bei der Auftragserstellung zu übergeben
Diesen Artikel teilen: