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¤cy=BTC&address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh' This request checks the validity of the address. :
https://changee.com/v1/api/validate-address
Result example :
{
result: true
} Parameter
| Parameter | Type | Example |
|---|---|---|
| key | string | 69ec18c455844bd0b5 |
| currency | string | BTC |
| address | string | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh |
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
| Parameter | Type | Example |
|---|---|---|
| key | string | 69ec18c455844bd0b5 |
| from | string | BTC |
| to | string | ETH |
| amount | float | 1 |
| fix | int 0 or 1 | 0 |
* 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
| Parameter | Type | Example |
|---|---|---|
| key | string | 69ec18c455844bd0b5 |
| from | string | BTC |
| to | string | USDT |
| amountTo | float | 5000 |
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
| Parameter | Type | Example |
|---|---|---|
| key | string | 69ec18c455844bd0b5 |
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
| Parameter | Type | Example |
|---|---|---|
| key | string | 69ec18c455844bd0b5 |
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
| Parameter | Type | Example |
|---|---|---|
| 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 |
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.15",
expectedAmountTo : "15.4",
amountFrom : "0.15",
date : "01.06.2023 21:51:12",
txId : null,
amountTo : null,
emergency : {status: EXPIRED},
result : true
} Parameter
| Parameter | Type | Example |
|---|---|---|
| key | string | 69ec18c455844bd0b5 |
| id | string | b4c312e6-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