To the main

Start

    API Endpoint

        https://changee.com/v1/api/
                

All requests sent to API Changee maust include the parameter key (API key) available after signing up to our Partnership Program.

Address Validation


# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/validate-address?key=69ec18c455844bd0b5&currency=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh'                

This request checks the validity of the address. :
https://changee.com/v1/api/validate-address



Result example :

{
    result: true
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5
currencystringBTC
addressstringbc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Exchange rate for transaction amount


# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/rate?key=69ec18c455844bd0b5&from=BTC&to=ETH&amount=1'                

This request gets the current exchange rate. Transaction fee is not included. :
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
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5
fromstringBTC
tostringETH
amountfloat1
fixint 0 or 10

* withdrawalFee - approximate commission for withdrawal. Floating parameter.
* fix: true - fixed rate, false - floating rate

Payment rate for transaction amount


# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/payment/rate?key=69ec18c455844bd0b5&from=BTC&to=USDT&amountTo=5000'                

This request allows you to get the current exchange rate and calculate the amount of funds you need to send to receive a payment. :
https://changee.com/v1/api/payment/rate



Result example :

{
    minamount: 2561.31,
    maxamount: 2930799,
    rate: 0.19879287,
    result: true
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5
fromstringBTC
tostringUSDT
amountTofloat5000

Currency List


# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/currencies?key=69ec18c455844bd0b5'                

This request gets the list of all available currencies. :
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
  },
  ...
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5

If the tagname is not an empty value, the tag is a mandatory parameter for this currency.

Pairs List


# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/pairs?key=69ec18c455844bd0b5'                

This request gets all pairs available for exchange. :
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"
  ],
  ...
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5

Exchange Initiation


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

This request creates – initiates - the exchange. :
https://changee.com/v1/api/exchange-create



Result example :

{
    id               : "lgla64f6fce131975",
    depositAddress   : "3QESviDMoQVEWR68sjHpz8P9eyEPLAUcNZ",
    depositTag       : "",
    expectedAmountTo : "235.11262",
    result           : true
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5
destinationAddressstring0x1ba42e5193dfa8b03d15dd1b86a3113bbbef8eeb
destinationTagstring(optional)
refundAddressstring1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2
refundTagstring(optional)
fromstringBTC
tostringZEC
amountfloat0.5
fixint 0 or 10

Getting exchange status


# Here is a curl example
curl \
-X GET 'https://changee.com/v1/api/exchange-status?key=69ec18c455844bd0b5&id=b4c312e6-199a-4572-a96a-9230badd7346'                

Getting information about the current exchange status :
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
}                

Parameter

ParameterTypeExample
keystring69ec18c455844bd0b5
idstringb4c312e6-199a-4572-a96a-9230badd7346

List of used statuses:
waiting_deposit - waiting for the deposit
deposit_received - deposit is received
exchanging - in the process of exchange
sending - in the process of sending
success - exchange completed successfully
time_expired - the waiting time for funds has expired
failed - the exchange ended with an error
sending_failed - sending attempt failed
reverted - the funds were returned to the client
payment_halted - funds have arrived but an exchange is on hold
The list of statuses of suspended orders:
EXPIRED - the transaction was received after the expiration of the order
LESS - a transaction was sent with an amount less than in the order