ทีม Quickex
10 พฤศจิกายน 2568
~2 นาทีในการอ่าน
การสร้างรายได้ผ่าน API (Markup)
มาร์กอัปอัตราแลกเปลี่ยนที่ควบคุมโดยพาร์ทเนอร์ รายได้ยืดหยุ่นผ่านการเชื่อมต่อ API
การคำนวณรายได้ B2B
ค่าธรรมเนียมแพลตฟอร์ม — 0.5–2% (ถูกรวมอยู่ในอัตรา)
Markup — มาร์กอัปของพาร์ทเนอร์ (ถูกรวมอยู่ในอัตรา)
รายได้จากผู้อ้างอิง — คำนวณจากค่าธรรมเนียมแพลตฟอร์ม (ไม่กระทบอัตรา)
ใช้เมื่อใด
- ขณะคำนวณอัตรา (แสดงตัวอย่าง)
- ขณะสร้างออเดอร์ (จำนวนสุดท้าย)
- ขณะจ่ายผลตอบแทนให้พาร์ทเนอร์
API endpoints
- 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)
Endpoint นี้ไม่ต้องใช้การยืนยันตัวตนและไม่จำเป็นต้องมี 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
{ "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 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"
}ตัวอย่างการคำนวณแบบเต็ม
ตัวอย่าง XMR (ค่าธรรมเนียมแพลตฟอร์ม → Markup → ค่าธรรมเนียมเครือข่าย), การจ่ายให้พาร์ทเนอร์ และมูลค่าใน 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 } }ค่าหลัก
| พารามิเตอร์ | ค่า | คำอธิบาย |
|---|---|---|
| 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 แบบขั้นบันได (Tiered / Ladder)
กติกาตามปริมาณ: อัตราที่แตกต่างกัน และสามารถเลือกได้ว่าจะรวมค่าธรรมเนียมเครือข่ายหรือไม่
การตั้งค่า (แนวคิด)
[ { "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”; อัตรา FIXED — 2%, FLOATING — 0.5%วิธีเป็นพาร์ทเนอร์และรับการจ่ายผลตอบแทน
- ลงทะเบียนใน Quickex และเปิดส่วน Partner Program (aff-ID) ในบัญชีของคุณ
- หากต้องการตั้งค่า markup ให้ติดต่อ ฝ่ายสนับสนุน (คำขอจะถูกส่งต่อไปยังทีมการตลาด)
- ผสานรวม widget/API และใช้พารามิเตอร์
markup
- ส่งคำขอถอนรายได้ผ่านบัญชีของคุณ
- ยอดขั้นต่ำ: 100 USDT
- เครือข่ายการจ่ายเงิน: USDT TRC20 (ตามค่าเริ่มต้น)
แนวทางที่แนะนำ
- หลีกเลี่ยงการตั้ง
markupสูงเกินไป — อาจทำให้ Conversion แย่ลง - ทดสอบระดับ (ladder) ตามปริมาณธุรกรรม
- แสดงอัตราสุดท้ายให้ผู้ใช้เห็นอย่างชัดเจน (โปร่งใส)
สำคัญ
รายได้จากผู้อ้างอิงคำนวณจาก ค่าธรรมเนียมแพลตฟอร์ม และไม่ถูกนำไปใช้ในสูตรคำนวณอัตราแลกเปลี่ยน
สิ่งที่ควรหลีกเลี่ยง
- ซ่อนค่าธรรมเนียมใน UI
- ค่าระดับ (ladder) ในระบบคำนวณไม่ตรงกับที่แสดงในเครื่องคิดเลข
- ลืมส่งพารามิเตอร์
markupขณะสร้างออเดอร์