Команда DxSpot

15 июня 2026 г.

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

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

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

GET

/api/v1/rates/public/one

Endpoint URL

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

Documentation

Возвращает актуальный публичный курс обмена для указанной торговой пары.
Метод используется для получения расчёта по конкретному направлению обмена с учётом введённой суммы, режима курса и дополнительных параметров.

URL

https://dxspot.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://dxspot.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": "Claimed amount is 1. Min processable amount is 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