API V1 Instruments

Возвращает список всех активных инструментов, доступных для обмена на платформе Dxspot.
Инструмент описывает конкретную валюту и сеть, в которой она работает (например, USDT (TRC20), BTC (BTC), EUR (SEPA)).
Данные можно использовать для отображения списка валют в интерфейсе обмена.

URL

https://dxspot.io/api/v1/instruments/public

Параметры

Отсутствуют

Пример запроса (cURL)

curl -X GET \
  'https://dxspot.io/api/v1/instruments/public' \
  -H 'Accept: application/json'

Пример ответа (200)

[
  {
    "currencyTitle": "GHS",
    "networkTitle": "GHS",
    "slug": "ghsghs",
    "currencyFriendlyTitle": "Ghanaian cedi",
    "precisionDecimals": 2,
    "currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/3540.png",
    "requiresMemo": false,
    "instrumentType": "fiat",
    "bestChangeName": ""
  },
  {
    "currencyTitle": "HUF",
    "networkTitle": "HUF",
    "slug": "hufhuf",
    "currencyFriendlyTitle": "Hungarian Forint",
    "precisionDecimals": 2,
    "currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/2793.png",
    "requiresMemo": false,
    "instrumentType": "fiat",
    "bestChangeName": ""
  }
]

Поля ответа:

• currencyTitle — тикер валюты (например, BTC, USDT, EUR).
• networkTitle — сеть, в которой работает данный инструмент (например, TRC20, ERC20, SEPA).
• currencyFriendlyTitle — человеко-читаемое название валюты.
• precisionDecimals — количество знаков после запятой, поддерживаемое системой.
• currencyLogoLink — ссылка на иконку валюты.
• requiresMemo — указывает, требуется ли memo/tag при переводе.
• instrumentType — тип инструмента (crypto или fiat).

Возвращает публичную информацию об одном активном инструменте на платформе Dxspot.
Используется, когда необходимо уточнить параметры конкретной валюты в нужной сети (например, USDT в сети TRC20).

URL

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

Параметры запроса (Query)

Пример запроса (cURL)

curl -X GET \
  'https://dxspot.io/api/v1/instruments/public/one?currencyTitle=USDT&networkTitle=TRC20' \
  -H 'Accept: application/json'

Пример ответа (200)

{
  "currencyTitle": "USDT",
  "networkTitle": "TRC20",
  "okexCurrencyFriendlyTitle": "USDT",
  "precisionDecimals": 2,
  "requiresMemo": false,
  "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
}

Примечания

• Метод позволяет уточнить свойства одного инструмента без загрузки полного списка.
• precisionDecimals указывает количество знаков после запятой, доступных для расчётов с этой валютой.
• requiresMemo показывает, нужно ли при переводах указывать Memo/Tag (актуально для некоторых сетей, например, XRP или XLM).
• Можно использовать для предварительной валидации при построении UI выбора валют и сетей.

/api/v1/instruments/public/validate-address
POST

Выполняет проверку корректности указанного адреса для выбранного инструмента.
Метод помогает убедиться, что введённый пользователем адрес соответствует формату сети (например, адрес TRC20 для USDT).
Используется перед отправкой транзакции или созданием заказа, чтобы минимизировать ошибки при вводе адреса.

URL

https://dxspot.io/api/v1/instruments/public/validate-address

Параметры

Отсутствуют (данные передаются в теле запроса).

Тело запроса (JSON)

{
  "currencyTitle": "USDT",
  "networkTitle": "TRC20",
  "address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}

Пример запроса (cURL)

curl -X POST \
  'https://dxspot.io/api/v1/instruments/public/validate-address' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "currencyTitle": "USDT",
  "networkTitle": "TRC20",
  "address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}'

Пример ответа (201)

true

Примечания

• Ответ true означает, что адрес корректен и может быть использован в транзакции.
• Ответ false вернётся, если адрес не соответствует формату выбранной сети.
• Рекомендуется вызывать этот метод на этапе ввода данных пользователем для предотвращения ошибок при создании заказов.