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