API (Markup)

Author profile photo
Команда Quickex
5 листопада 2025 р.
~3 хв. читання

Монетизація через API (Markup)

Markup під контролем партнера. Гнучкий дохід через інтеграцію API.

B2B-нарахування
Комісія платформи — 0.5–2% (у курсі)
Markup — націнка партнера (у курсі)
Реферальне нарахування — з Комісії платформи (не впливає на курс)
Коли застосовується
  • Під час розрахунку курсу (прев’ю)
  • Під час створення заявки (фінальні суми)
  • Під час виплат партнеру
API endpoints
  • GET /api/v1/rates/public/one
  • POST /api/v2/orders/public/create

Що бачить користувач і скільки заробляє партнер?

Якщо курс Quickex BTC → USDT дорівнює 100,000, а партнер встановлює markup = 0.5%, користувач, який перейшов за партнерським посиланням, отримає ~99,500, а різниця 500 піде партнеру як дохід від markup. Додатково партнер може отримати реферальну виплату з Комісії платформи.

Як працює розрахунок з Markup

Комісія платформи та Markup впливають на курс; реферальне нарахування — ні.

Попередній розрахунок курсу
A_final = A_calculated × (1 − (K_markup / 100))
Параметр Опис
A_final Кінцева сума до отримання (прогноз)
A_calculated Сума до застосування markup
K_markup Відсоток markup
Приклад: 49549.728 × (1 − 0.3/100) = 49401.078
Кінцева виплата клієнту (створення заявки)
A_withdrawal = A_exchange × (1 − ((C_platform + K_markup) / 100))
Виплата партнеру (після COMPLETED)
C_affiliate = (C_platform × C_affiliate_percent / 100) + (C_platform × K_markup / 100)

Отримання курсу (з урахуванням markup)

Endpoint без автентифікації та без IP whitelist.

Request
GET /api/v1/rates/public/one?instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&rateMode=FLOATING&claimedDepositAmount=1&markup=0.3
Фрагмент відповіді
{ "instrumentFrom": { "currencyTitle": "BTC", "networkTitle": "BTC" }, "instrumentTo": { "currencyTitle": "USDT","networkTitle": "TRC20" }, "amountToGive": "1", "amountToGet": "50201.90689595", "markup": "0.3" }
Параметри запиту
Параметр Опис Приклад
instrumentFromCurrencyTitle Валюта відправлення BTC
instrumentFromNetworkTitle Мережа валюти відправлення BTC
instrumentToCurrencyTitle Валюта отримання USDT
instrumentToNetworkTitle Мережа валюти отримання TRC20
rateMode FLOATING / FIXED FLOATING
claimedDepositAmount Сума депозиту 1
markup Відсоток markup 0.3

Створення заявки з використанням markup

Передавайте поле markup у тілі запиту.

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

Повний приклад розрахунку

Приклад для XMR (Комісія платформи → Markup → Комісія мережі), виплати партнеру та розрахунок в USDT.

Початковий 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 } }

Ключові значення
Параметр Значення Опис
fundingAvailableBalance 2.9982 XMR Баланс до виведення
orderPlatformFeeAbsoluteAmount 0.014761061416 XMR Комісія платформи (0.5%)
markup 1.65% Markup партнера
networkFee.actualNetworkFee 0.002 XMR Комісія мережі
performWithdrawal.amountToWithdrawFact 2.93221219 XMR Кінцева сума до виведення
performWithdrawal.amountToWithdrawFactUSDT 976.6319 USDT Кінцева сума в USDT

Кроки:
  1. Відняти комісію платформи: 2.9982 − 0.014761061416 = 2.983438938584 XMR
  2. Застосувати markup 1.65%: 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
  3. Відняти комісію мережі: 2.9342122 − 0.002 = 2.932212196097364 XMR
Клієнт отримує: 2.93221219 XMR ≈ 976.63 USDT

Виплата партнеру
ReferralReward = PlatformFee × (Affiliate%/100) = 0.007380973823 XMR (за 50%)
PartnerMarkup = FinalXMR × (markup/100) = 0.048381501135 XMR
Разом партнеру: 0.055770474958 XMR
Виплата в USDT
PartnerTotalUSDT = PartnerTotalXMR × Rate = 0.055770474958 × 333.12 ≈ 18.5444 USDT

Багаторівневий (ladder) механізм Markup

Тир-сітка за обсягом: різні відсотки та можливість враховувати комісії мережі.

Конфігурація (концепт)
[ { "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 } ]
Логіка вибору тиру
  1. Взяти claimedDepositAmount із запиту
  2. Знайти останній тир, де Amount from ≤ claimedDepositAmount
  3. Використати його відсотки (для розрахунку та калькулятора)
Приклад: для claimedDepositAmount = 9000 обрати тир “від 9000”; фіксований курс — 2%, плаваючий — 0.5%.

Як стати партнером та отримувати виплати

  1. Зареєструйтеся на Quickex і відкрийте розділ Партнерська програма (aff-ID) у особистому кабінеті
  2. Щоб встановити markup, зверніться до служби підтримки (запит передається в маркетинг)
  3. Інтегруйте віджет/API та використовуйте параметр markup
  • Запит на виплату через особистий кабінет
  • Мінімальна сума: 100 USDT
  • Мережа виплати: USDT TRC20 (за замовчуванням)

Найкращі практики
  • Уникайте надмірного markup — це погіршує конверсію
  • Тестуйте багаторівневі (“ladder”) тарифи за обсягами
  • Показуйте користувачу фінальний курс (прозорість)
Важливо
Реферальне нарахування розраховується з Комісії платформи і не бере участі в розрахунку курсу.
Анти-патерни
  • Приховані комісії в інтерфейсі
  • Невідповідність “ladder”-тирів між розрахунками та калькулятором
  • Забути передати markup під час створення заявки
Поділитись статтею: