Monetización mediante API (Markup)

Author profile photo
Equipo Quickex
5 de noviembre de 2025
~3 lectura mínima

Monetización vía API (Markup)

Markup de tipo controlado por el socio. Ingresos flexibles mediante integración API.

Devengos B2B
Comisión de la plataforma — 0.5–2% (en la tasa)
Markup — recargo del socio (en la tasa)
Devengo por referido — desde la Comisión de la plataforma (no afecta la tasa)
Cuándo se aplica
  • En el cálculo de la tasa (previsualización)
  • En la creación del pedido (montos finales)
  • En los pagos al socio
Endpoints API
  • GET /api/v1/rates/public/one
  • POST /api/v2/orders/public/create

¿Qué ve el usuario y qué gana el socio?

Si la tasa Quickex BTC → USDT es 100,000 y el socio establece markup = 0.5%, el usuario que siga el enlace del socio recibirá ~99,500, y la diferencia de 500 será tomada por el socio como ingreso por markup. Adicionalmente, el socio puede recibir un pago de referido desde la Comisión de la plataforma.

Cómo funciona el cálculo con Markup

La Comisión de la plataforma y el Markup afectan la tasa; el Devengo por referido no.

Cálculo preliminar de la tasa
A_final = A_calculated × (1 − (K_markup / 100))
Parámetro Descripción
A_final Monto final a recibir (previsto)
A_calculated Monto antes de aplicar el markup
K_markup Porcentaje de markup
Ejemplo: 49549.728 × (1 − 0.3/100) = 49401.078
Pago final al cliente (creación del pedido)
A_withdrawal = A_exchange × (1 − ((C_platform + K_markup) / 100))
Pago al socio (después de COMPLETED)
C_affiliate = (C_platform × C_affiliate_percent / 100) + (C_platform × K_markup / 100)

Obtención de la tasa (con markup aplicado)

Endpoint sin autenticación ni 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
Fragmento de respuesta
{ "instrumentFrom": { "currencyTitle": "BTC", "networkTitle": "BTC" }, "instrumentTo": { "currencyTitle": "USDT","networkTitle": "TRC20" }, "amountToGive": "1", "amountToGet": "50201.90689595", "markup": "0.3" }
Parámetros de la request
Parámetro Descripción Ejemplo
instrumentFromCurrencyTitle Moneda de origen BTC
instrumentFromNetworkTitle Red de la moneda de origen BTC
instrumentToCurrencyTitle Moneda de destino USDT
instrumentToNetworkTitle Red de la moneda de destino TRC20
rateMode FLOATING / FIXED FLOATING
claimedDepositAmount Monto del depósito 1
markup Porcentaje de markup 0.3

Creación de un pedido con markup

Pasa el campo markup en el cuerpo de la 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"
}

Ejemplo completo de cálculo

Ejemplo con XMR (Comisión de la plataforma → Markup → Comisión de red), pagos al socio y en USDT.

JSON de origen
{ "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 clave
Parámetro Valor Descripción
fundingAvailableBalance 2.9982 XMR Saldo antes del retiro
orderPlatformFeeAbsoluteAmount 0.014761061416 XMR Comisión de la plataforma (0.5%)
markup 1.65% Markup del socio
networkFee.actualNetworkFee 0.002 XMR Comisión de red
performWithdrawal.amountToWithdrawFact 2.93221219 XMR Monto final a retirar
performWithdrawal.amountToWithdrawFactUSDT 976.6319 USDT Monto final en USDT

Pasos:
  1. Restar la comisión de la plataforma: 2.9982 − 0.014761061416 = 2.983438938584 XMR
  2. Aplicar 1.65% de markup: 2.983438938584 × (1 − 0.0165) ≈ 2.9342122 XMR
  3. Restar la comisión de red: 2.9342122 − 0.002 = 2.932212196097364 XMR
El cliente recibe: 2.93221219 XMR ≈ 976.63 USDT

Pago al socio
ReferralReward = PlatformFee × (Affiliate%/100) = 0.007380973823 XMR (al 50%)
PartnerMarkup = FinalXMR × (markup/100) = 0.048381501135 XMR
Total para el socio: 0.055770474958 XMR
Pago en USDT
PartnerTotalUSDT = PartnerTotalXMR × Rate = 0.055770474958 × 333.12 ≈ 18.5444 USDT

Mecanismo escalonado (ladder) para Markup

Reglas escalonadas basadas en volumen: diferentes porcentajes y si incluir o no las comisiones de red.

Configuración (concepto)
[ { "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 selección del escalón
  1. Tomar claimedDepositAmount de la request
  2. Encontrar el último escalón donde Amount from ≤ claimedDepositAmount
  3. Usar sus porcentajes (para el cálculo y para el calculador)
Ejemplo: para claimedDepositAmount = 9000, elegir el escalón “desde 9000”; tasa fija — 2%, flotante — 0.5%.

Cómo convertirse en socio y recibir pagos

  1. Regístrate en Quickex y abre la sección de Programa de socios (aff-ID) en tu cuenta
  2. Para establecer un markup, contacta con soporte (la solicitud va al marketing)
  3. Integra el widget/API y usa markup
  • Solicitud de pago a través de la cuenta
  • Monto mínimo: 100 USDT
  • Red de pago: USDT TRC20 (por defecto)

Buenas prácticas
  • Evita un markup excesivo — perjudica la conversión
  • Prueba los escalones “ladder” por volúmenes
  • Muestra la tasa final al usuario (transparencia)
Importante
El Devengo por referido se calcula desde la Comisión de la plataforma y no participa en el cálculo de la tasa.
Anti-patrones
  • Comisiones ocultas en la interfaz
  • Valores de escalones “ladder” incongruentes entre los cálculos y el calculador
  • Olvidar pasar markup al crear un pedido
Comparte este artículo: