Команда DxSpot

15 июня 2026 г.

~1 мин. чтения

Раздел Rates предоставляет методы для получения актуальных курсов обмена на платформе Dxspot. Под курсом понимается отношение одной валюты к другой в рамках определённой торговой пары (например, BTC → USDT).

Эти данные позволяют строить калькуляторы обмена, отображать актуальные котировки пользователю и определять, сколько целевой валюты вы получите при обмене. В данном разделе доступен метод для получения одного конкретного курса в формате JSON.

GET

rates/public/one

Endpoint URL

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

Documentation

Общее описание

Запрос возвращает расчёт одного обменного курса для заданной пары инструментов и суммы депозита.

HTTP-запрос

Метод: GET
URL: https://dxspot.io/api/v2/rates/public/one

Пример запроса

curl -X GET \
 'https://dxspot.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	yes	Код валюты, которую пользователь отдаёт (например, BTC).
instrumentFromNetworkTitle	string	yes	Сеть исходного инструмента (BTC, ERC20, TRC20).
instrumentToCurrencyTitle	string	yes	Код валюты, которую пользователь получает (например, USDT).
instrumentToNetworkTitle	string	yes	Сеть целевого инструмента (TRC20, ERC20).
instrumentFromSlug	string	no	Slug исходного инструмента в системе Dxspot.
instrumentToSlug	string	no	Slug целевого инструмента.
claimedDepositAmountCurrency	string	yes	Код валюты, в которой указывается сумма депозита.
claimedDepositAmount	number	no	Сумма, которую пользователь намерен отправить.
rateMode	string	no	Режим курса: fixed или float.
exchangeType	string	yes	Тип операции: crypto / fiat / stablecoin.
referrerId	number	no	ID партнёра.
markup	number	no	Наценка партнёра на курс (например, 0.01 = +1%).

Формат ответа

Метод возвращает объект 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	Slug инструмента.
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

Поделиться статьей:

Rates API V2