To the main

Начало работы

    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&currency=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh'                

Этот запрос определяет правильность введённого адреса :
https://changee.com/v1/api/validate-address



Result example :

{
    result: true
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5
currencystringBTC
addressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Получение курса на сумму обмена


# 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
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5
fromstringBTC
tostringETH
amountfloat1
fixint 0 or 10

* 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
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5
fromstringBTC
tostringUSDT
amountTofloat5000

Список валют


# 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
  },
  ...
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5

Если 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"
  ],
  ...
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5

Создание обмена


# 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
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5
destinationAddressstring0x1ba42e5193dfa8b03d15dd1b86a3113bbbef8eeb
destinationTagstring(optional)
refundAddressstring1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2
refundTagstring(optional)
fromstringBTC
tostringZEC
amountfloat0.5
fixint 0 or 10

Получение статуса обмена


# 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
}                

Параметр

ПараметрТипПример
keystring69ec18c455844bd0b5
idstringb4c312e6-199a-4572-a96a-9230badd7346

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