RatesQuickex Exchange Rates: Retrieval and Calculation

Команда Quickex

17 листопада 2025 р.

~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