تیم Quickex

۱۹ آبان ۱۴۰۴

~3 دقیقه خوانده شده

درآمدزایی از طریق API (Markup)

افزودن کارمزد در نرخ با کنترل شریک. درآمد انعطاف‌پذیر از طریق یکپارچه‌سازی API.

تسویه‌های B2B

کارمزد پلتفرم — 0.5–2% (در نرخ لحاظ شده)

Markup — مارک‌آپ شریک (در نرخ لحاظ شده)

دریافت ارجاعی — از کارمزد پلتفرم (روی نرخ تأثیر ندارد)

زمان اعمال

در محاسبه نرخ (نمایش پیش‌فرض)
در ایجاد سفارش (مبالغ نهایی)
در پرداخت‌ها به شریک

نقاط پایانی API

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 روی نرخ اثر می‌گذارند؛ دریافت ارجاعی نه.

محاسبه نرخ اولیه

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`)

نقطه پایانی بدون احراز هویت و بدون نیاز به لیست سفید IP.

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	درصد مارک‌آپ	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%	مارک‌آپ شریک
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

سازوکار پلکانی (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 }
]

منطق انتخاب پله

مقدار claimedDepositAmount را از درخواست بگیرید
آخرین پله‌ای را بیابید که در آن Amount from ≤ claimedDepositAmount
درصدهای همان پله را برای محاسبه و نمایش در محاسبه‌گر استفاده کنید

مثال: برای claimedDepositAmount = 9000، پله «از 9000» انتخاب می‌شود؛ نرخ ثابت — 2%، شناور — 0.5%.

چگونه شریک شوید و پرداخت دریافت کنید

در Quickex ثبت‌نام کنید و بخش برنامه شراکت (Partner Program) (aff-ID) را در حساب خود باز کنید
برای تنظیم مارک‌آپ، با پشتیبانی تماس بگیرید (درخواست به تیم مارکتینگ ارجاع می‌شود)
ویجت/API را یکپارچه کرده و از پارامتر markup استفاده کنید

درخواست برداشت از طریق حساب کاربری
حداقل مبلغ: 100 USDT
شبکه پرداخت: USDT TRC20 (پیش‌فرض)

بهترین رویه‌ها

از markup بیش از حد خودداری کنید — روی تبدیل (Conversion) اثر منفی دارد
پله‌های پلکانی (ladder) را بر اساس حجم تست کنید
نرخ نهایی را شفاف به کاربر نمایش دهید

مهم

دریافت ارجاعی از کارمزد پلتفرم محاسبه می‌شود و در محاسبه نرخ نقشی ندارد.

الگوهای نادرست

کارمزدهای پنهان در رابط کاربری
عدم انطباق مقادیر پله‌های پلکانی بین منطق محاسبه و محاسبه‌گر
فراموش کردن ارسال markup هنگام ایجاد سفارش

این مقاله را به اشتراک بگذارید:

درآمدزایی از طریق API (Markup)

درآمدزایی از طریق API (Markup)

نحوه محاسبه با Markup

دریافت نرخ (با اعمال markup)

ایجاد سفارش با markup

نمونه کامل محاسبه

سازوکار پلکانی (Ladder) برای Markup

چگونه شریک شوید و پرداخت دریافت کنید

دریافت نرخ (با اعمال `markup`)

ایجاد سفارش با `markup`