Exchange

Do you want to use?
contact us

Request

POST /api/v3/order/exchange/create

{
  "merchantOrderId": "1697637323",
  "amountFrom": "1.23",
  "currencyFrom": "usd",
  "currencyTo": "eur",
  "webhookUrl": "https://example.com/webhook-url/1697637323"
}

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
}

Exchange

Request

Response

Errors list

Order status

Get rates for exchange

Rates request

Rates response

Are there any inquiries still outstanding?

Exchange