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

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

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

post

Header parameters

x-api-public-keystringOptional

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

x-api-signaturestringOptional

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

Content-typestringOptional

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

Example: application/json

Body

advancedBalanceIdstringRequired

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

Example: 2db11a99-a1cb-44f1-ba3b-ee41d80f53be

clientIdstringOptional

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

Example: merchant_unique_id

addressFromIdstringRequired

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

Example: e5b79674-72aa-46c5-9bc0-6c71176bbd61

addressToIdstringRequired

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

Example: 5681c552-2aff-4818-9f80-a20f7181b7ff

feeTokenstringRequired

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

Example: U2FsdGVkX1+mY2BlP3aKDL0b35LbOiDYeg3h8m9wel0IFhsqGIE1CD+3I0vIrppzQ2ZMpJhEZElBlW100tF/46ReHvSbTeUFnjxFkNdo2lFf6xQbpPgilPQM+Vw5pNSVdWtPrrOGbExHqRrqJipBdy+55h5+xN1vZ8j216zR0KQoH4hsK5oGW4xkEjkwZCio7jrqKQaF17hus9vl8ofKfQ==

webhookUrlstringOptional

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

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

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/swaps/create HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 483

{
  "advancedBalanceId": "2db11a99-a1cb-44f1-ba3b-ee41d80f53be",
  "clientId": "merchant_unique_id",
  "addressFromId": "e5b79674-72aa-46c5-9bc0-6c71176bbd61",
  "addressToId": "5681c552-2aff-4818-9f80-a20f7181b7ff",
  "feeToken": "U2FsdGVkX1+mY2BlP3aKDL0b35LbOiDYeg3h8m9wel0IFhsqGIE1CD+3I0vIrppzQ2ZMpJhEZElBlW100tF/46ReHvSbTeUFnjxFkNdo2lFf6xQbpPgilPQM+Vw5pNSVdWtPrrOGbExHqRrqJipBdy+55h5+xN1vZ8j216zR0KQoH4hsK5oGW4xkEjkwZCio7jrqKQaF17hus9vl8ofKfQ==",
  "webhookUrl": "https://merchant.domain/webhooks/swap"
}

200Success

{
  "success": true,
  "response": {
    "id": "62809beb-ce35-4861-a9e9-1e75f068f46f",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "2db11a99-a1cb-44f1-ba3b-ee41d80f53be",
    "addressFromId": "e5b79674-72aa-46c5-9bc0-6c71176bbd61",
    "addressToId": "5681c552-2aff-4818-9f80-a20f7181b7ff",
    "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": "2025-05-14T13:39:50.470Z"
  }
}