Команда Quickex

26 сентября 2025 г.

~3 мин. чтения

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

Наценка к курсу, управляемая партнёром. Гибкий доход через интеграцию API.

B2B начисления

Platform Fee — 0.5–2% (в курсе)

Markup — наценка партнёра (в курсе)

Referral Accrual — от Platform Fee (в курсе не участвует)

Когда применяется

В расчёте курса (предпросмотр)
В создании ордера (финальные суммы)
В партнёрских выплатах

API-эндпоинты

GET /api/v1/rates/public/one
POST /api/v2/orders/public/create

Что видит пользователь и что зарабатывает партнёр?

Если на Quickex курс BTC → USDT равен 100 000, а партнёр установил markup = 0.5%, пользователь по партнёрской ссылке получит ~99 500, а разницу 500 заберёт партнёр как доход по маркапу. Отдельно партнёру может начисляться реферальная выплата от Platform Fee.

Как работает расчёт с Markup

Platform Fee и Markup участвуют в формировании курса; Referral Accrual — нет.

Предварительный рассчёт курса

A_final = A_calculated × (1 − (K_markup / 100))

Параметр	Описание
`A_final`	Итоговая сумма к получению (предсказанная)
`A_calculated`	Сумма до применения `markup`
`K_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`)

Эндпоинт без авторизации и whitelist IP.

Запрос

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	Процент наценки	0.3

Создание ордера с `markup`

Передайте поле markup в теле запроса.

Запрос

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 пример (Platform Fee → Markup → Network Fee), выплаты партнёру и в 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%	Наценка партнёра
networkFee.actualNetworkFee	0.002 XMR	Сетевая комиссия
performWithdrawal.amountToWithdrawFact	2.93221219 XMR	Итог к выводу
performWithdrawal.amountToWithdrawFactUSDT	976.6319 USDT	Итог в USDT

Шаги:

Вычитаем комиссию платформы: 2.9982 − 0.014761061416 = 2.983438938584 XMR
Применяем маркап 1.65%: 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
Вычитаем сеть: 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

Механизм «лесенки» для 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 }
]

Логика выбора ступени

Берём claimedDepositAmount из запроса
Находим последнюю ступень, где Сумма от ≤ claimedDepositAmount
Используем её проценты (для расчёта и для калькулятора)

Пример: для claimedDepositAmount = 9000 берём ступень “от 9000”; фиксированный курс — 2%, плавающий — 0.5%.

Как стать партнёром и получать выплаты

Зарегистрируйтесь на Quickex и откройте раздел Партнёрская программа (aff-ID) в ЛК
Для установки маркапа обратитесь в саппорт (заявка уходит в маркетинг)
Интегрируйте виджет/API и используйте markup

Запрос на выплату через ЛК
Минимальная сумма: 100 USDT
Сеть выплат: USDT TRC20 (по умолчанию)

Лучшие практики

Избегайте слишком высокого markup — страдает конверсия
Тестируйте ступени “лесенки” по объёмам
Отображайте пользователю итоговый курс (прозрачность)

Важно

Referral Accrual начисляется от Platform Fee и не участвует в расчёте курса.

Анти-паттерны

Скрытые комиссии в UI
Несогласованные значения “лесенки” в расчётах и калькуляторе
Забыли передать markup при создании ордера

Поделиться статьей:

Монетизация