Начало работы
API Endpoint https://changee.com/v1/api/
Все запросы к API Changee должны содержать параметр key
(API key) доступный после регистрации в Партнёрской программе.
Валидация адреса
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/validate-address?key=69ec18c455844bd0b5¤cy=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh'
Этот запрос определяет правильность введённого адреса :
https://changee.com/v1/api/validate-address
Result example :
{
result: true
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
currency | string | BTC |
address | string | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
Получение курса на сумму обмена
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/rate?key=69ec18c455844bd0b5&from=BTC&to=ETH&amount=1'
Этот запрос получает текущий курс. Ставка не включает комиссию за транзакцию (майнер), взимаемую с каждой транзакции. :
https://changee.com/v1/api/rate
Result example :
{
fix: false,
minamount: 0.05,
maxamount: 100,
fromNetwork: "Bitcoin",
toNetwork: "ERC20",
rate: 13.38099645346961,
withdrawalFee: "0.00119 ETH",
result: true
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
from | string | BTC |
to | string | ETH |
amount | float | 1 |
fix | int 0 or 1 | 0 |
* withdrawalFee - примерная комиссия за вывод. Плавающий параметр.
* fix: true - фиксированный курс, false - плавающий курс
Получение курса на сумму платежа
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/payment/rate?key=69ec18c455844bd0b5&from=BTC&to=USDT&amountTo=5000'
Данный запрос позволяет получить текущий курс обмена и рассчитать сумму средств, которую необходимо отправить для получения платежа. :
https://changee.com/v1/api/payment/rate
Result example :
{
minamount: 2561.31,
maxamount: 2930799,
rate: 0.19879287,
result: true
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
from | string | BTC |
to | string | USDT |
amountTo | float | 5000 |
Список валют
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/currencies?key=69ec18c455844bd0b5'
Этот запрос получает список всех доступных монет. :
https://changee.com/v1/api/currencies
Result example :
{
XMR: {
coinName: "Monero",
minamount: 12.27,
maxamount: 15527,
tagname: "",
network: "Monero",
available: true
},
ETH: {
coinName: "Ethereum",
minamount: 1.33,
maxamount: 1693,
tagname: "",
network: "ERC20",
available: true
},
DAI: {
coinName: "Dai",
minamount: 2127.89,
maxamount: 2746236,
tagname: "",
network: "ERC20",
available: true
},
EOS: {
coinName: "EOS",
minamount: 2072.91,
maxamount: 2526315,
tagname: "MEMO",
network: "EOS",
available: true
},
...
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
Если tagname не пустое значение, то для этой валюты тэг обязателен.
Список всех пар
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/pairs?key=69ec18c455844bd0b5'
Этот запрос получает список всех доступных для обмена пар. :
https://changee.com/v1/api/pairs
Result example :
{
BTC: [
"USDT",
"BUSD",
"BNB",
"ETH",
"PAX",
"MATIC"
],
USDT: [
"BTC",
"XRP",
"DOGE",
"ETH"
],
DASH: [
"XMR",
"TUSD",
"ATOM"
],
XTZ: [
"USDT",
"BTC"
],
EOS: [
"ETH",
"PERL"
],
ADA: [
"TRX"
],
TUSD: [
"USDT"
],
ALGO: [
"BTC"
],
...
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
Создание обмена
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/exchange-create?key=69ec18c455844bd0b5&from=BTC&to=ZEC&amount=0.5&fix=0&destinationAddress=t1PS2q82NcaDvjr2ZSAeVfLh79Xmbfutv5j&refundAddress=1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2'
Этот запрос создаёт обмен. :
https://changee.com/v1/api/exchange-create
Result example :
{
id : "lgla64f6fce131975",
depositAddress : "3QESviDMoQVEWR68sjHpz8P9eyEPLAUcNZ",
depositTag : "",
expectedAmountTo : "235.11262",
result : true
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
destinationAddress | string | 0x1ba42e5193dfa8b03d15dd1b86a3113bbbef8eeb |
destinationTag | string | (optional) |
refundAddress | string | 1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2 |
refundTag | string | (optional) |
from | string | BTC |
to | string | ZEC |
amount | float | 0.5 |
fix | int 0 or 1 | 0 |
Получение статуса обмена
# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/exchange-status?key=69ec18c455844bd0b5&id=b4c312e6-199a-4572-a96a-9230badd7346'
Получение информации о текущем статусе обмена :
https://changee.com/v1/api/exchange-status
Result example :
{
status : "deposit_received",
from : "BTC",
to : "ZEC",
depositAddress : "18cBEMRxXHqzWWCxZNtU91F5sbUNKhL5PX",
depositTag : "",
depositTxId : "86e66391ecf40a51fa6dfe5da91d6f8077fdffa8a900d26e1a5c14369d17bc75",
destinationAddress : "t1PS2q82NcaDvjr2ZSAeVfLh79Xmbfutv5j",
destinationTag : "",
refundAddress : "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2",
refundTag : "",
expectedAmountFrom : "0.5",
expectedAmountTo : "235.11262",
amountFrom : "0.5",
date : "01.01.2023 14:51:22",
txId : null,
amountTo : null,
emergency : {status: EXPIRED},
result : true
}
Параметр
Параметр | Тип | Пример |
---|---|---|
key | string | 69ec18c455844bd0b5 |
id | string | b4c312e6-199a-4572-a96a-9230badd7346 |
Список используемых статусов: waiting_deposit
- ожидание депозита deposit_received
- депозит получен exchanging
- в процессе обмена sending
- в процессе отправки success
- обмен успешно завершен time_expired
- вышло время ожидания средств failed
- обмен завершился с ошибкой sending_failed
- попытка отправки завершилась с ошибкой reverted
- клиенту были возвращены его средства payment_halted
- средства пришли, но обмен приостановлен
Список статусов для преостановленных ордеров: EXPIRED
- транзакция была получена после истечения срока действия ордера LESS
- транзакция была отправлена на сумму меньшую, чем в заказе