Rates API V2

تیم Quickex

۲۱ آذر ۱۴۰۴

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

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

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

GET

rates/public/one

Endpoint URL

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

Documentation

توضیحات کلی

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

درخواست HTTP

متد: GET
URL: https://quickex.io/api/v2/rates/public/one

نمونه درخواست

curl -X GET \
 'https://quickex.io/api/v2/rates/public/one
  ?instrumentFromCurrencyTitle=BTC
  &instrumentFromNetworkTitle=BTC
  &instrumentToCurrencyTitle=USDT
  &instrumentToNetworkTitle=TRC20
  &instrumentFromSlug=btc
  &instrumentToSlug=usdttrc20
  &claimedDepositAmountCurrency=BTC
  &rateMode=fixed
  &referrerId=123
  &claimedDepositAmount=0.082539
  &markup=0.0
  &exchangeType=crypto' \
-H 'accept: application/json'

پارامترهای درخواست

پارامترهای Query

پارامتر	نوع	الزامی	توضیحات
instrumentFromCurrencyTitle	string	بله	کد ارزی که کاربر می‌فرستد (مثلاً BTC).
instrumentFromNetworkTitle	string	بله	شبکه‌ی ابزار مبدأ (BTC، ERC20، TRC20).
instrumentToCurrencyTitle	string	بله	کد ارزی که کاربر دریافت می‌کند (مثلاً USDT).
instrumentToNetworkTitle	string	بله	شبکه‌ی ابزار مقصد (TRC20، ERC20).
instrumentFromSlug	string	خیر	اسلاگ ابزار مبدأ در سیستم Quickex.
instrumentToSlug	string	خیر	اسلاگ ابزار مقصد.
claimedDepositAmountCurrency	string	بله	کد ارزی که مبلغ واریز بر حسب آن مشخص شده است.
claimedDepositAmount	number	خیر	مبلغی که کاربر قصد ارسال آن را دارد.
rateMode	string	خیر	حالت نرخ: fixed یا float.
exchangeType	string	بله	نوع عملیات: crypto / fiat / stablecoin.
referrerId	number	خیر	شناسه‌ی شریک (Partner ID).
markup	number	خیر	مارک‌آپ شریک روی نرخ (مثلاً 0.01 = ۱٪+).

قالب پاسخ

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

نمونه پاسخ

{
  "instrumentFrom": {
    "currencyTitle": "BTC",
    "networkTitle": "BTC",
    "slug": "btc",
    "precisionDecimals": 7
  },
  "instrumentTo": {
    "currencyTitle": "USDT",
    "networkTitle": "TRC20",
    "slug": "usdttrc20",
    "precisionDecimals": 2
  },
  "claimedDepositAmount": "0.082539",
  "depositRules": null,
  "platformFee_Absolute": "",
  "withdrawalRules": null,
  "minConfirmationsToWithdraw": 3,
  "minConfirmationsToTrade": 3,
  "updatedAt": 1764661006130,
  "liquidityProviderPublicCode": "hat",
  "amountToGet": "7031.14",
  "amountToGetUSDT": "7031.148333816",
  "amountToGive": "0.082539",
  "marketMinAmount": "",
  "enableFixedRate": true,
  "ckms": false,
  "ckm": "D",
  "amountToGiveCurrencyTitle": "BTC",
  "rateMode": "fixed",
  "finalNetworkFeeAmount": "1.5",
  "liquidityProviderQuotes": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "86942.8"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "1"
    }
  },
  "price": "85185.7707727983133388",
  "leftPrice": "85185.7707727983133388",
  "rightPrice": "0.0000112693615569",
  "marketLeftPrice": "86942.8",
  "marketRightPrice": "0.0000115018017572",
  "marketAmountToGet": "7176.1717692",
  "marketAmountToGetUSDT": "7176.1717692",
  "quotesWithoutNetworkFee": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "85203.944"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "0.98"
    }
  },
  "quotes": {
    "sellQuote": {
      "baseValue": "1",
      "quoteValue": "85185.77077279831333884"
    },
    "buyQuote": {
      "baseValue": "86942.9",
      "quoteValue": "0.9797909749030203"
    }
  },
  "generalMinAmount": "0.0011501",
  "generalMaxAmount": "0.09171",
  "debugInfo": null
}

توضیح فیلدهای پاسخ

اطلاعات ابزار

"instrumentFrom": {
  "currencyTitle": "BTC",
  "networkTitle": "BTC",
  "slug": "btc",
  "precisionDecimals": 7
},
"instrumentTo": {
  "currencyTitle": "USDT",
  "networkTitle": "TRC20",
  "slug": "usdttrc20",
  "precisionDecimals": 2
}

</tr >

فیلد	نوع	توضیحات
instrumentFrom	object	ابزار مبدأ.
instrumentTo	object	ابزار مقصد.
currencyTitle	string	کد ارز.
networkTitle	string	شبکه.
slug	string	اسلاگ ابزار.
precisionDecimals	number	تعداد ارقام اعشار.

مقادیر و پارامترهای کلیدی

"claimedDepositAmount": "0.082539",
"amountToGive": "0.082539",
"amountToGiveCurrencyTitle": "BTC",
"amountToGet": "7031.14",
"amountToGetUSDT": "7031.148333816",
"rateMode": "fixed",
"enableFixedRate": true,
"finalNetworkFeeAmount": "1.5",
"generalMinAmount": "0.0011501",
"generalMaxAmount": "0.09171"

فیلد	نوع	توضیحات
claimedDepositAmount	string	مبلغ واریزی که کاربر درخواست کرده است.
amountToGive	string	مبلغ نهایی برای ارسال.
amountToGiveCurrencyTitle	string	ارز مبلغی که ارسال می‌شود.
amountToGet	string	مبلغی که کاربر دریافت خواهد کرد.
amountToGetUSDT	string	مقدار معادل بر حسب USDT.
rateMode	string	حالت نرخ: fixed یا float.
enableFixedRate	boolean	در دسترس بودن نرخ ثابت.
finalNetworkFeeAmount	string	کارمزد نهایی شبکه.
generalMinAmount	string	حداقل واریز ممکن.
generalMaxAmount	string	حداکثر واریز ممکن.

Code Sample

Response Example

Try it out

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