Exchange
Do you want to use?
Request
POST /api/v3/order/exchange/create
{
"merchantOrderId": "1697637323",
"amountFrom": "1.23",
"currencyFrom": "usd",
"currencyTo": "eur",
"webhookUrl": "https://example.com/webhook-url/1697637323"
}
Response
Response
{
"data": {
"id": "38435d18-23d3-46af-853d-faf16d336cd6",
"merchantOrderId": "1697637323",
"type": "exchange",
"createdAt": "2024-07-18T09:18:12+00:00",
"status": "new"
},
"error": null
}
Errors list
| Code | Description |
|---|---|
INVALID_DATA |
Invalid request data. Check json syntax |
VALIDATION |
Validation error. See error.validationErrors for details |
METHOD_NOT_FOUND |
Endpoint not found |
INVALID_HTTP_METHOD |
Only POST method allowed |
AUTHENTICATION_FAILED |
Check your api token |
ORDER_ALREADY_EXISTS |
Order with same merchantOrderId already exists |
ORDER_NOT_FOUND |
Specified order was not found |
REJECTED_DUE_TO_TECHNICAL_ISSUE |
Rejected due to technical issue |
REQUEST_FROM_UNTRUSTED_SOURCE |
Request from untrusted source (ip not allowed) |
PAYIN_DISABLED |
Payment disabled. Contact us to enable |
PAYOUT_DISABLED |
Withdrawal disabled. Contact support to enable |
WALLET_NOT_FOUND |
Wallet not found. Contact support to enable wallet |
WALLET_INACTIVE |
Wallet inactive. Contact support to enable wallet |
ROUTING_NOT_CONFIGURED |
Routing not configured. Please contact us for details |
POINT_NOT_FOUND |
There is no way to process transaction. If issue is persistent please contact us for additional details |
AMOUNT_GREATER_THAN_ALLOWED |
Operation amount greater than allowed |
AMOUNT_LESS_THAN_ALLOWED |
Operation amount less than allowed |
NOT_ENOUGH_BALANCE |
Operation amount greater than available balance |
OPERATION_NOT_SUPPORTED |
Operation not supported |
REFERER_REQUEST_DOES_NOT_MATCH_ALLOWED_SOURCES |
Referer from request does not match user hosts. Please contact us if you have any questions. |
UNKNOWN |
Unknown error |
Order status
Refer to the Status & Webhook section for generic guidance.
POST /api/v3/order/get-status
{
"merchantOrderId": "1697637323"
}
Processing
Completed
Rejected
Response
{
"data": {
"id": "38435d18-23d3-46af-853d-faf16d336cd6",
"merchantOrderId": "exchange-1721294292-uah_usd",
"type": "exchange",
"createdAt": "2024-07-18T09:18:12+00:00",
"status": "processing",
"merchantSourceWallet": {
"amount": "19.23",
"currency": "usd"
},
"merchantTargetWallet": {
"amount": "18.92",
"currency": "eur"
},
"transactions": [
{
"type": "exchange",
"id": "7f9c1e68-dc3c-43e9-a622-78dbe077a710",
"status": "processing",
"merchantSourceWallet": {
"amount": "19.23",
"currency": "usd"
},
"merchantTargetWallet": {
"amount": "18.92",
"currency": "eur"
},
"createdAt": "2024-07-18T09:18:12+00:00",
"completedAt": "2024-07-18T09:18:12+00:00"
}
]
},
"error": null
}
Response
{
"data": {
"id": "38435d18-23d3-46af-853d-faf16d336cd6",
"merchantOrderId": "exchange-1721294292-uah_usd",
"type": "exchange",
"createdAt": "2024-07-18T09:18:12+00:00",
"status": "completed",
"merchantSourceWallet": {
"amount": "19.23",
"currency": "usd"
},
"merchantTargetWallet": {
"amount": "18.92",
"currency": "eur"
},
"transactions": [
{
"type": "exchange",
"id": "7f9c1e68-dc3c-43e9-a622-78dbe077a710",
"status": "completed",
"merchantSourceWallet": {
"amount": "19.23",
"currency": "usd"
},
"merchantTargetWallet": {
"amount": "18.92",
"currency": "eur"
},
"createdAt": "2024-07-18T09:18:12+00:00",
"completedAt": "2024-07-18T09:18:12+00:00"
}
]
},
"error": null
}
Response
{
"data": {
"id": "38435d18-23d3-46af-853d-faf16d336cd6",
"merchantOrderId": "exchange-1721294292-uah_usd",
"type": "exchange",
"createdAt": "2024-07-18T09:18:12+00:00",
"status": "rejected",
"merchantSourceWallet": {
"amount": "19.23",
"currency": "usd"
},
"merchantTargetWallet": {
"amount": "18.92",
"currency": "eur"
},
"transactions": [
{
"type": "exchange",
"id": "7f9c1e68-dc3c-43e9-a622-78dbe077a710",
"status": "rejected",
"merchantSourceWallet": {
"amount": "19.23",
"currency": "usd"
},
"merchantTargetWallet": {
"amount": "18.92",
"currency": "eur"
},
"createdAt": "2024-07-18T09:18:12+00:00",
"completedAt": "2024-07-18T09:18:12+00:00"
}
]
},
"error": null
}
Get rates for exchange
Get actual rates for exchange
Rates request
Request POST /api/v3/rates
{ }
Rates response
Response POST /api/v3/rates
{
"data": [
{
"base": "eth",
"quote": "usdt",
"value": "2.6",
"minAmount": "1"
},
{
"base": "eth",
"quote": "btc",
"value": "0.019296",
"minAmount": "1"
},
{
"base": "usdt",
"quote": "btc",
"value": "0.000017",
"minAmount": "1"
},
{
"base": "btc",
"quote": "usdt",
"value": "94650.01",
"minAmount": "1"
},
{
"base": "eur",
"quote": "uah",
"value": "43",
"minAmount": "1"
},
{
"base": "uah",
"quote": "eur",
"value": "0.02326",
"minAmount": "1"
},
{
"base": "usdt",
"quote": "eth",
"value": "0.385",
"minAmount": "1"
},
{
"base": "usd",
"quote": "uah",
"value": "40",
"minAmount": "1"
},
{
"base": "uah",
"quote": "usd",
"value": "0.025",
"minAmount": "1"
},
{
"base": "usdt",
"quote": "uah",
"value": "46",
"minAmount": "1"
},
{
"base": "uah",
"quote": "usdt",
"value": "0.0222",
"minAmount": "1"
},
{
"base": "uah",
"quote": "kzt",
"value": "12.16",
"minAmount": "1"
},
{
"base": "kzt",
"quote": "uah",
"value": "0.048",
"minAmount": "1"
}
],
"error": null
}
Are there any inquiries still outstanding?
Our team of experts is available 24/7 to answer all your questions. Feel free to reach out to us at any time, and we will be happy to help you address any inquiries or issues. Your comfort and satisfaction are our priority.