Создание кроссчейн обмена

Метод позволяет создать кроссчейн обмен. Кроссчейн обмен позволяет обменять один актив на другой

Создание кроссчейн обмена

post

Header parameters

x-api-public-keystringoptional

Публичный API-ключ

x-api-signaturestringoptional

Подпись тела запроса приватным API-ключем

Content-typestringoptional

Тип тела запроса

Example: application/json

Body

advancedBalanceIdstringrequired

Идентификатор авансового баланса, указанный при создании токена комисси

Example: 50781c26-1005-4b1e-94ea-a19a17017e90

clientIdstringoptional

Уникальный идентификатор обмена в системе мерчанта (для предотвращения дублирования запросов)

Example: merchant_unique_id

addressFromIdstringrequired

Идентификатор исходящего адреса, с которого будет списанна указанная сумма

Example: 47ce6b06-bce3-4172-b2a4-ce5206487491

addressToIdstringrequired

Идентификатор адреса назначения, куда будут зачислены монеты после обмена

Example: 680e45d0-2fb5-46c0-aef1-555b3b997ece

feeTokenstringrequired

Токен комиссии

Example: U2FsdGVkX19gwxf4omULAkjSe+Wr+Vp2A4bwQ1nI+EvBF31quNfmVD4EFGqAnBTMe5wdXiS/myh7IOyM3Dmi5kkWfvaBnnE5UVq/SVAaFAANdqjqWbVu5SWyHBwteEKJoJel5M4olq9fNeYOnLVR6oPw0EEaTaM+Aa1Wb1VmenpU3rkrEp14ws67SXIP05L26+M00BK2xTL9Wi+Wz8nVPg==

webhookUrlstringoptional

URL адрес для уведомления об изменении статуса операции обмена

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/swaps/create' \
  --header 'Content-Type: application/json' \
  --data '{
    "advancedBalanceId": "50781c26-1005-4b1e-94ea-a19a17017e90",
    "clientId": "merchant_unique_id",
    "addressFromId": "47ce6b06-bce3-4172-b2a4-ce5206487491",
    "addressToId": "680e45d0-2fb5-46c0-aef1-555b3b997ece",
    "feeToken": "U2FsdGVkX19gwxf4omULAkjSe+Wr+Vp2A4bwQ1nI+EvBF31quNfmVD4EFGqAnBTMe5wdXiS/myh7IOyM3Dmi5kkWfvaBnnE5UVq/SVAaFAANdqjqWbVu5SWyHBwteEKJoJel5M4olq9fNeYOnLVR6oPw0EEaTaM+Aa1Wb1VmenpU3rkrEp14ws67SXIP05L26+M00BK2xTL9Wi+Wz8nVPg==",
    "webhookUrl": "https://merchant.domain/webhooks/swap"
  }'

200

200

{
  "success": true,
  "response": {
    "id": "75cdbf17-64a7-410e-af39-8c68b47bc0ff",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "50781c26-1005-4b1e-94ea-a19a17017e90",
    "addressFromId": "47ce6b06-bce3-4172-b2a4-ce5206487491",
    "addressToId": "680e45d0-2fb5-46c0-aef1-555b3b997ece",
    "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-12-25T14:35:23.171Z"
  }
}