Документация Exwell API

Начало работы
Все запросы к API Exwell должны содержать параметр `key` (API key) доступный после регистрации в Партнёрской программе.

API URI https://exwell.io/v1/api

Response type json

GET REQUESTS

`/validate-address` - Валидация адреса
Этот запрос определяет правильность введённого адреса

GET

https://exwell.io/v1/api/validate-address?key=1QdX7HY2GTZ7HQTHg&currency=USDT&address=0x651bf10b18d1ecaf7753cfe2457ac1aa23de540b

Параметр

Параметр	Тип	Пример
key	`string`	`1QdX7HY2GTZ7HQTHg`
currency	`string`	`USDT`
address	`string`	`0x651bf10b18d1ecaf7753cfe2457ac1aa23de540b`

Response 200

{
    "result":true
}

`/rate` - Получение курса на сумму обмена
Этот запрос получает текущий курс. Ставка не включает комиссию за транзакцию (майнер), взимаемую с каждой транзакции.

GET

https://exwell.io/v1/api/rate?key=1QdX7HY2GTZ7HQTHg&from=ZEC&to=BTC&amount=1000

Параметр

Параметр	Тип	Пример
key	`string`	`1QdX7HY2GTZ7HQTHg`
from	`string`	`ZEC`
to	`string`	`BTC`
amount	`float`	`1000`

Response 200

{
  "minamount": 100.4,
  "maxamount": 121334,
  "rate": 0.9835947505534923,
  "withdrawalFee": 0.002 BTC,
  "result": true
}

* withdrawalFee - примерная комиссия за вывод. Плавающий параметр.

`/currencies` - Список валют
Этот запрос получает список всех доступных монет.

GET

https://exwell.io/v1/api/currencies?key=1QdX7HY2GTZ7HQTHg

Параметр

Параметр	Тип	Пример
key	`string`	`1QdX7HY2GTZ7HQTHg`

Response 200

{
  "XMR": {
    "coinName": "Monero",
    "minamount": 20.01,
    "maxamount": 23724,
    "tagname": "",
    "network":"Monero",
    "available": true
  },
  "ZEC": {
    "coinName": "Zcash",
    "minamount": 110.06,
    "maxamount": 132304,
    "tagname": "",
    "network":"Zcash",
    "available": true
  },
  "XRP": {
    "coinName": "XRP",
    "minamount": 6180.12,
    "maxamount": 7343941,
    "tagname": "TAG",
    "network":"Ripple",
    "available": true
  },
  "XLM": {
    "coinName": "Stellar",
    "minamount": 34429.06,
    "maxamount": 41095890,
    "tagname": "MEMO",
    "network":"Stellar Lumens",
    "available": true
  },
  ...
}

Примечание

Если tagname не пустое значение, то для этой валюты тэг обязателен.

`/pairs` - Список всех пар
Этот запрос получает список всех доступных для обмена пар.

GET

https://exwell.io/v1/api/pairs?key=1QdX7HY2GTZ7HQTHg

Параметр

Параметр	Тип	Пример
key	`string`	`1QdX7HY2GTZ7HQTHg`

Response 200

{
  "ZEC": [
    "BTC",
    "USDT",
    "USDC",
    "ETH",
    "BTCLIGHTNING",
    "USDTTRC20"
  ],
  "DASH": [
    "USDC",
    "BTC",
    "ETH",
    "USDCTRC20"
  ],
  "DOT": [
    "USDT",
    "BTC",
    "USDC"
  ],
  ...
}

`/exchange-create` - Создание обмена
Этот запрос создаёт обмен.

GET

https://exwell.io/v1/api/exchange-create?key=1QdX7HY2GTZ7HQTHg&from=XMR&to=ZEC&amount=26.4509&destinationAddress=33NWPY7z4vHzMnuyzRJg6hUvMXDw5Y7v9o&refundAddress=87mEgetMnPSMMKsAFRRf7UMKLSdzdke99Rk63PYZv5hYeUmx29gEd9PKbwiQ7ZsYv7AJMKZ3515E

Параметр

Параметр	Тип	Пример
key	`string`	`1QdX7HY2GTZ7HQTHg`
destinationAddress	`string`	`33NWPY7z4vHzMnuyzRJg6hUvMXDw5Y7v9o`
destinationTagoptional	`string`
refundAddress	`string`	`87mEgetMnPSMMKsAFRRf7UMKLSdzdke99Rk63PYZv5hYeUmx29gEd9PKbwiQ7ZsYv7AJMKZ3515E`
refundTagoptional	`string`
from	`string`	`XMR`
to	`string`	`BTC`
amount	`float`	`26.4509`

Response 200

{
    'id'                 : '43c393b8-1dc6-40e3-ad83-d721bf467ac1',
    'from'               : 'XMR',
    'to'                 : 'BTC',
    'expectedAmountFrom' : '26.4509',
    "expectedAmountTo"   : '0.24118351760777',
    'depositAddress'     : '87mEgetMnPSMMKsAFRRf7UMKLSdzdke99Rk63PYZv5hYeUmx29gEd9PKbwiQ7ZsYv7AJMKZ3515E',
    'depositTag'         : '',
}

`/exchange-status` - Получение статуса обмена
Получение информации о текущем статусе обмена

GET

https://exwell.io/v1/api/exchange-status?key=1QdX7HY2GTZ7HQTHg&id=43c393b8-1dc6-40e3-ad83-d721bf467ac1

Параметр

Параметр	Тип	Пример
key	`string`	`1QdX7HY2GTZ7HQTHg`
id	`string`	`43c393b8-1dc6-40e3-ad83-d721bf467ac1`

Response 200

{
    'status'             : 'deposit_received',
    'from'               : 'XMR',
    'to'                 : 'BTC',
    'depositAddress'     : '87mEgetMnPSMMKsAFRRf7UMKLSdzdke99Rk63PYZv5hYeUmx29gEd9PKbwiQ7ZsYv7AJMKZ3515EtJ6uxZvWmksLFtMi7qM',
    'depositTag'         : '',
    'depositTxId'        : '',
    'destinationAddress' : '33NWPY7z4vHzMnuyzRJg6hUvMXDw5Y7v9o',
    'destinationTag'     : '',
    'refundAddress'      : '87mEgetMnPSMMKsAFRRf7UMKLSdzdke99Rk63PYZv5hYeUmx29gEd9PKbwiQ7ZsYv7AJMKZ3515E',
    'refundTag'          : '',
    'expectedAmountFrom' : '26.4509',
    'expectedAmountTo'   : '0.24118351760777',
    'amountFrom'         : '26.4509',
    'date'               : '01.06.2023 10:24:30',
    'txId'               : null,
    'amountTo'           : null,
    'result'             : true
}

Примечание

Список используемых статусов:
waiting_deposit - ожидание депозита
deposit_received - депозит получен
exchanging - в процессе обмена
sending - в процессе отправки
success - обмен успешно завершен
time_expired - вышло время ожидания средств
failed - обмен завершился с ошибкой
sending_failed - попытка отправки завершилась с ошибкой
reverted - клиенту были возвращены его средства

Если возникнут вопросы по интеграции, мы с радостью ответим: