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

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

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

post

Header parameters

x-api-public-keystringOptional

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

x-api-signaturestringOptional

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

Content-typestringOptional

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

Example: application/json

Body

advancedBalanceIdstringRequired

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

Example: d464decd-5cc8-42de-8f57-c55a862d0e87

clientIdstringOptional

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

Example: merchant_unique_id

addressFromIdstringRequired

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

Example: 4b40f3ab-687b-48b5-bd67-0e76b189ea3c

addressToIdstringRequired

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

Example: e99fc2b1-5ba5-4e76-bbed-b07d06f9ebc4

feeTokenstringRequired

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

Example: U2FsdGVkX1/OMswrmemYrGjxRNjv28gjkMYbQ7vAtcO4fxY9ooyLqYlHeKnRgQ37jELbDiCbPrDqNfidbyViMSftlJUxnXO/mxDp1On8feJ/y7OZOl8xtRCOTTDGJQuvukHsyRLp41EZVbevaOxYVlBa2KA7U8Xq+Ic+wtYxZm3Et+6mJ4BHfeBjFYwr2QOz5cqJj+ItF5oprMM/np7SAQ==

webhookUrlstringOptional

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

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

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

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

{
  "advancedBalanceId": "d464decd-5cc8-42de-8f57-c55a862d0e87",
  "clientId": "merchant_unique_id",
  "addressFromId": "4b40f3ab-687b-48b5-bd67-0e76b189ea3c",
  "addressToId": "e99fc2b1-5ba5-4e76-bbed-b07d06f9ebc4",
  "feeToken": "U2FsdGVkX1/OMswrmemYrGjxRNjv28gjkMYbQ7vAtcO4fxY9ooyLqYlHeKnRgQ37jELbDiCbPrDqNfidbyViMSftlJUxnXO/mxDp1On8feJ/y7OZOl8xtRCOTTDGJQuvukHsyRLp41EZVbevaOxYVlBa2KA7U8Xq+Ic+wtYxZm3Et+6mJ4BHfeBjFYwr2QOz5cqJj+ItF5oprMM/np7SAQ==",
  "webhookUrl": "https://merchant.domain/webhooks/swap"
}

200Success

{
  "success": true,
  "response": {
    "id": "0c2b1f46-b92f-4b49-b0af-1beaac73ed5a",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "d464decd-5cc8-42de-8f57-c55a862d0e87",
    "addressFromId": "4b40f3ab-687b-48b5-bd67-0e76b189ea3c",
    "addressToId": "e99fc2b1-5ba5-4e76-bbed-b07d06f9ebc4",
    "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:50:31.655Z"
  }
}