Creation of a cross-chain exchange

The method allows you to create a cross-chain exchange. Cross-chain exchange allows you to exchange one asset for another

Creation of a cross-chain exchange

POSThttps://ocp.onchainpay.io/api-gateway/swaps/create

Header parameters

Body

application/json

advancedBalanceId*string

Identifier of the upfront balance specified when creating the commission token

Example: "882f4ed6-82c8-43c3-8dd6-d755cee5f1af"

clientIdstring

Unique exchange identifier in the merchant system (to prevent duplicate requests)

Example: "merchant_unique_id"

addressFromId*string

Identifier of the outgoing address from which the specified amount will be debited

Example: "7504dcc8-e87e-4dce-862f-0a9b765bfbda"

addressToId*string

Identifier of the destination address where the coins will be credited after the swap

Example: "92d7b5bf-69b3-480e-84ce-5f3555aa9ebb"

feeToken*string

Commission Token

Example: "U2FsdGVkX18xY+n+kQ0n9W9Z05aLH3CT203J6apJFd2/XKGM7FR0k+Ieeblj0VgfVmByKXF5Dq4056ge5ggq2JzrXnUtd4k0sWZMpALpi8esAEhf+izE1C2FCTHQmAbONPFrHVNwRtwBatSIZ4as1c/JiakVkfimxKKbAch/MLOiyg+OCJoAfIV7AI8P9kvun9rZ3MmCeNAizGeMHT3K7w=="

webhookUrlstring

URL address for notifying about the change in the status of the swap operation

Example: "https://merchant.domain/webhooks/swap"

Response

200

Body

application/json

success*boolean

Request success indicator

response*SwapResponse (object)

The body of the response to the request for obtaining data from the swap

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/swaps/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "advancedBalanceId": "882f4ed6-82c8-43c3-8dd6-d755cee5f1af",
      "addressFromId": "7504dcc8-e87e-4dce-862f-0a9b765bfbda",
      "addressToId": "92d7b5bf-69b3-480e-84ce-5f3555aa9ebb",
      "feeToken": "U2FsdGVkX18xY+n+kQ0n9W9Z05aLH3CT203J6apJFd2/XKGM7FR0k+Ieeblj0VgfVmByKXF5Dq4056ge5ggq2JzrXnUtd4k0sWZMpALpi8esAEhf+izE1C2FCTHQmAbONPFrHVNwRtwBatSIZ4as1c/JiakVkfimxKKbAch/MLOiyg+OCJoAfIV7AI8P9kvun9rZ3MmCeNAizGeMHT3K7w=="
    }),
});
const data = await response.json();

Response

200

{
  "success": false,
  "response": {
    "id": "06e34c7c-a4e5-4da6-9a9b-cab43810d6d5",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "882f4ed6-82c8-43c3-8dd6-d755cee5f1af",
    "addressFromId": "7504dcc8-e87e-4dce-862f-0a9b765bfbda",
    "addressToId": "92d7b5bf-69b3-480e-84ce-5f3555aa9ebb",
    "currencyFrom": "USDT",
    "currencyTo": "USDC",
    "networkFrom": "ethereum",
    "networkTo": "tron",
    "status": "PENDING",
    "rejectMessage": "null",
    "amountFrom": "200",
    "amountTo": "200",
    "price": "1",
    "serviceBlockchainFeeSource": "ADVANCE",
    "serviceBlockchainFee": "2",
    "serviceBlockchainFeeUSD": "2",
    "providerBlockchainFeeSource": "AMOUNT",
    "providerBlockchainFee": "2",
    "providerBlockchainFeeUSD": "2",
    "serviceFeeSource": "ADVANCE",
    "serviceFee": "2",
    "serviceFeeUSD": "2",
    "webhookUrl": "https://merchant.domain/webhooks/swap",
    "createdAt": "2024-11-07T12:41:09.829Z"
  }
}