Team Quickex

September 29, 2025

~3 min read

Monetization via API (Markup)

Partner-controlled rate markup. Flexible revenue through API integration.

B2B accruals

Platform Fee — 0.5–2% (in the rate)

Markup — partner markup (in the rate)

Referral Accrual — from Platform Fee (does not affect the rate)

When applied

In rate calculation (preview)
In order creation (final amounts)
In partner payouts

API endpoints

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

What does the user see and what does the partner earn?

If the Quickex rate BTC → USDT equals 100,000 and the partner sets markup = 0.5%, a user following the partner link will receive ~99,500, and the difference 500 will be taken by the partner as markup income. Separately, the partner may receive a referral payout from the Platform Fee.

How the calculation with Markup works

Platform Fee and Markup affect the rate; Referral Accrual does not.

Preliminary rate calculation

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

Parameter	Description
`A_final`	Final amount to receive (predicted)
`A_calculated`	Amount before applying `markup`
`K_markup`	Markup percentage

Example: 49549.728 × (1 − 0.3/100) = 49401.078

Final payout to the customer (order creation)

A_withdrawal = A_exchange × (1 − ((C_platform + K_markup) / 100))

Partner payout (after COMPLETED)

C_affiliate = (C_platform × C_affiliate_percent / 100) + (C_platform × K_markup / 100)

Fetching the rate (with `markup` applied)

Endpoint without authentication and IP whitelist.

Request

GET /api/v1/rates/public/one?instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&rateMode=FLOATING&claimedDepositAmount=1&markup=0.3

Response snippet

{
  "instrumentFrom": { "currencyTitle": "BTC", "networkTitle": "BTC" },
  "instrumentTo":   { "currencyTitle": "USDT","networkTitle": "TRC20" },
  "amountToGive": "1",
  "amountToGet":  "50201.90689595",
  "markup": "0.3"
}

Request parameters

Parameter	Description	Example
instrumentFromCurrencyTitle	Source currency	BTC
instrumentFromNetworkTitle	Source currency network	BTC
instrumentToCurrencyTitle	Target currency	USDT
instrumentToNetworkTitle	Target currency network	TRC20
rateMode	FLOATING / FIXED	FLOATING
claimedDepositAmount	Deposit amount	1
markup	Markup percentage	0.3

Creating an order with `markup`

Pass the markup field in the request body.

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

Full calculation example

XMR example (Platform Fee → Markup → Network Fee), partner payouts and in USDT.

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

Key values

Parameter	Value	Description
fundingAvailableBalance	2.9982 XMR	Balance before withdrawal
orderPlatformFeeAbsoluteAmount	0.014761061416 XMR	Platform fee (0.5%)
markup	1.65%	Partner markup
networkFee.actualNetworkFee	0.002 XMR	Network fee
performWithdrawal.amountToWithdrawFact	2.93221219 XMR	Final to withdraw
performWithdrawal.amountToWithdrawFactUSDT	976.6319 USDT	Final in USDT

Steps:

Subtract the platform fee: 2.9982 − 0.014761061416 = 2.983438938584 XMR
Apply 1.65% markup: 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
Subtract network fee: 2.9342122 − 0.002 = 2.932212196097364 XMR

Customer receives: 2.93221219 XMR ≈ 976.63 USDT

Partner payout

ReferralReward = PlatformFee × (Affiliate%/100) = 0.007380973823 XMR (at 50%)

PartnerMarkup = FinalXMR × (markup/100) = 0.048381501135 XMR

Total to partner: 0.055770474958 XMR

Payout in USDT

PartnerTotalUSDT = PartnerTotalXMR × Rate = 0.055770474958 × 333.12 ≈ 18.5444 USDT

Tiered (ladder) mechanism for Markup

Volume-based tiered rules: different percentages and whether to include network fees.

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

Step selection logic

Take claimedDepositAmount from the request
Find the last tier where Amount from ≤ claimedDepositAmount
Use its percentages (for calculation and for the calculator)

Example: for claimedDepositAmount = 9000, choose the tier “from 9000”; fixed rate — 2%, floating — 0.5%.

How to become a partner and get payouts

Register on Quickex and open the Partner Program section (aff-ID) in your account
To set a markup, contact support (the request goes to marketing)
Integrate the widget/API and use markup

Payout request via the account
Minimum amount: 100 USDT
Payout network: USDT TRC20 (by default)

Best practices

Avoid excessive markup — conversion suffers
Test “ladder” tiers by volumes
Display the final rate to the user (transparency)

Important

Referral Accrual is calculated from the Platform Fee and does not participate in the rate calculation.

Anti-patterns

Hidden fees in the UI
Mismatched “ladder” tier values between calculations and the calculator
Forgetting to pass markup when creating an order

Share this article:

API (Markup)