RatesQuickex Exchange Rates: Retrieval and Calculation

تیم Quickex

۲۶ آبان ۱۴۰۴

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

بخش Rates روش‌هایی را برای دریافت نرخ‌های واقعی تبادل در پلتفرم Quickex ارائه می‌دهد.
نرخ به‌عنوان نسبت یک ارز به ارز دیگر در یک جفت معاملاتی مشخص در نظر گرفته می‌شود
(برای مثال BTC → USDT).

این داده‌ها به شما امکان می‌دهد ماشین‌حساب‌های تبادل ایجاد کنید، قیمت‌های به‌روز را به کاربر نمایش دهید
و تعیین کنید هنگام تبادل چه مقدار از ارز مقصد دریافت خواهید کرد.
در این بخش، یک روش برای دریافت یک نرخ مشخص به فرمت JSON در دسترس است.

GET

public/one

Endpoint URL

https://quickex.io/api/v1/rates/public/one

Documentation

نرخ عمومی فعلی برای جفت‌ارز مشخص‌شده را بازمی‌گرداند.
این متد برای محاسبه جهت مشخصی از تبادل استفاده می‌شود و مقدار واردشده، حالت نرخ و پارامترهای اضافی را در نظر می‌گیرد.

URL

https://quickex.io/api/v1/rates/public/one

پارامترهای Query

پارامتر	نوع	ضروری	توضیح
`exchangeType`	string	بله	نوع تبادل (مثلاً `crypto`).
`instrumentFromCurrencyTitle`	string	بله	ارز مبدأ (مثلاً `BTC`).
`instrumentFromNetworkTitle`	string	بله	شبکه ارز مبدأ (مثلاً `BTC` یا `ERC20`).
`instrumentToCurrencyTitle`	string	بله	ارز مقصد (مثلاً `USDT`).
`instrumentToNetworkTitle`	string	بله	شبکه ارز مقصد (مثلاً `TRC20`).
`claimedDepositAmount`	string	خیر	مبلغ واریزی برای محاسبه نرخ.
`rateMode`	string	خیر	حالت نرخ: `FLOATING` (شناور) یا `FIXED` (ثابت).
`claimedDepositAmountCurrency`	string	بله	ارزی که مبلغ واریزی در آن مشخص شده است (مثلاً `USDT`).
`markup`	string	خیر	مارکاپ نرخ (مثلاً `1.00`).
`referrerId`	string	خیر	شناسه شریک/ارجاع‌دهنده (مثلاً `aff_some-affiliate-id`).

نمونه درخواست (cURL)

curl -X GET \
  'https://quickex.io/api/v1/rates/public/one?exchangeType=crypto&instrumentFromCurrencyTitle=BTC&instrumentFromNetworkTitle=BTC&instrumentToCurrencyTitle=USDT&instrumentToNetworkTitle=TRC20&claimedDepositAmount=1.00&rateMode=FLOATING&claimedDepositAmountCurrency=USDT&markup=1.00&referrerId=aff_some-affiliate-id' \
  -H 'Accept: application/json'

نمونه پاسخ (422 — خطا)

{
  "status": "ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL",
  "message": "Claimed Deposit Amount Too Small Error",
  "data": {
    "localizedMessage": "مبلغ واردشده 1 است. حداقل مبلغ قابل پردازش 108.51 می‌باشد",
    "details": {
      "field": "claimedDepositAmount",
      "value": "1",
      "expected": "108.51",
      "expectedGeneral": "108.51"
    }
  }
}

نمونه پاسخ (200 — موفقیت)

{
  "depositRules": {
    "minAmount": "1000.1",
    "maxAmount": "1000.1"
  },
  "withdrawalRules": {
    "minAmount": "1000.1",
    "maxAmount": "1000.1",
    "withdrawalFeeRules": {
      "minAmount": "1000.1",
      "maxAmount": "1000.1"
    }
  },
  "minConfirmationsToWithdraw": 0,
  "minConfirmationsToTrade": 0,
  "instrumentFrom": {
    "currencyTitle": "BTC",
    "networkTitle": "BTC",
    "precisionDecimals": 8
  },
  "instrumentTo": {
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "precisionDecimals": 2
  },
  "price": "108.51"
}

نکات

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

اگر مبلغ واریزی خیلی کم باشد، خطای ERR_CLAIMED_DEPOSIT_AMOUNT_TOO_SMALL برگردانده می‌شود.

پارامتر rateMode می‌تواند روی حالت شناور یا ثابت تنظیم شود.

پارامترهای markup و referrerId برای یکپارچه‌سازی شرکای تجاری و ماشین‌حساب‌های سفارشی تبادل مفید هستند.

Code Sample

Response Example

Try it out

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

API V1 Rates