Equipe Quickex

10 de novembro de 2025

~3 min de leitura

Monetização via API (Markup)

Markup controlado pelo parceiro. Receita flexível através da integração via API.

Acumulados B2B

Taxa da Plataforma — 0.5–2% (inclusa na taxa)

Markup — markup do parceiro (incluso na taxa)

Comissão de Referência — a partir da Taxa da Plataforma (não afeta a taxa)

Quando se aplica

No cálculo da taxa (pré-visualização)
Na criação do pedido (valores finais)
Nos pagamentos ao parceiro

Endpoints da API

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

O que o usuário vê e quanto o parceiro ganha?

Se a taxa Quickex BTC → USDT for 100,000 e o parceiro definir markup = 0.5%, o usuário que seguir o link do parceiro receberá cerca de 99,500, e a diferença de 500 será o lucro do parceiro com o markup. Separadamente, o parceiro também pode receber uma comissão de referência a partir da Taxa da Plataforma.

Como funciona o cálculo com Markup

A Taxa da Plataforma e o Markup afetam a taxa; a Comissão de Referência não.

Cálculo preliminar da taxa

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

Parâmetro	Descrição
`A_final`	Valor final a receber (previsto)
`A_calculated`	Valor antes de aplicar o `markup`
`K_markup`	Percentual de markup

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

Pagamento final ao cliente (criação do pedido)

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

Pagamento ao parceiro (após COMPLETED)

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

Obter a taxa (com `markup` aplicado)

Endpoint sem autenticação e sem whitelist de IP.

Request

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

Trecho da resposta

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

Parâmetros da request

Parâmetro	Descrição	Exemplo
instrumentFromCurrencyTitle	Moeda de origem	BTC
instrumentFromNetworkTitle	Rede da moeda de origem	BTC
instrumentToCurrencyTitle	Moeda de destino	USDT
instrumentToNetworkTitle	Rede da moeda de destino	TRC20
rateMode	FLOATING / FIXED	FLOATING
claimedDepositAmount	Valor do depósito	1
markup	Percentual de markup	0.3

Criando um pedido com `markup`

Inclua o campo markup no corpo (body) da request.

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

Exemplo completo de cálculo

Exemplo com XMR (Taxa da Plataforma → Markup → Taxa de Rede), pagamentos ao parceiro e valores em USDT.

JSON de origem

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

Valores principais

Parâmetro	Valor	Descrição
fundingAvailableBalance	2.9982 XMR	Saldo antes do saque
orderPlatformFeeAbsoluteAmount	0.014761061416 XMR	Taxa da plataforma (0.5%)
markup	1.65%	Markup do parceiro
networkFee.actualNetworkFee	0.002 XMR	Taxa de rede
performWithdrawal.amountToWithdrawFact	2.93221219 XMR	Valor final a sacar
performWithdrawal.amountToWithdrawFactUSDT	976.6319 USDT	Valor final em USDT

Passos:

Subtrair a taxa da plataforma: 2.9982 − 0.014761061416 = 2.983438938584 XMR
Aplicar 1.65% de markup: 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
Subtrair a taxa de rede: 2.9342122 − 0.002 = 2.932212196097364 XMR

Cliente recebe: 2.93221219 XMR ≈ 976.63 USDT

Pagamento ao parceiro

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

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

Total para o parceiro: 0.055770474958 XMR

Pagamento em USDT

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

Mecanismo de Markup por faixas (ladder)

Regras por volume: diferentes percentuais e opção de incluir ou não as taxas de rede.

Configuração (conceito)

[ { "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 } ]

Lógica de seleção da faixa

Usar o claimedDepositAmount da request
Encontrar a última faixa em que Amount from ≤ claimedDepositAmount
Aplicar seus percentuais (para o cálculo e para o simulador)

Exemplo: para claimedDepositAmount = 9000, escolher a faixa “a partir de 9000”; taxa fixa — 2%, flutuante — 0.5%.

Como se tornar parceiro e receber pagamentos

Registre-se na Quickex e abra a seção Programa de Parceiros (aff-ID) na sua conta
Para definir o markup, contate o suporte (a solicitação é encaminhada ao marketing)
Integre o widget/API e use o parâmetro markup

Pedido de saque via conta
Valor mínimo: 100 USDT
Rede de pagamento: USDT TRC20 (por padrão)

Boas práticas

Evite markup excessivo — prejudica a conversão
Teste faixas “ladder” por volume
Mostre a taxa final ao usuário (transparência)

Importante

A Comissão de Referência é calculada a partir da Taxa da Plataforma e não participa do cálculo da taxa.

Más práticas

Taxas ocultas na interface
Valores das faixas “ladder” inconsistentes entre o cálculo e o simulador
Esquecer de enviar o markup ao criar o pedido

Compartilhe este artigo:

API (Markup)