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

post

/api-gateway/swaps/create

Header parameters

x-api-public-keystring

Public API-key

x-api-signaturestring

Signing the request body with a private API-key

Content-typestring

Request content type

Example: application/json

Body

advancedBalanceIdstringrequired

Identifier of the upfront balance specified when creating the commission token

Example: f9565f73-eb15-4246-9954-169eeb9475fc

clientIdstring

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

Example: merchant_unique_id

addressFromIdstringrequired

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

Example: 21d8a948-5b69-45b9-8a4d-898be4df18e6

addressToIdstringrequired

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

Example: 3c436d99-5b52-4b2c-b752-d8b3e9f8ae0e

feeTokenstringrequired

Commission Token

Example: U2FsdGVkX1/FIpPE+Ch/nGia1sP/OahFtB7gSay76eRVdOej3tVnkzhM/figukozPK8C9KsC6nElUeiPpoJTDUXNzc9wl0P0a1cYNSGMAnUu6VTgaJmV9saymORGHqCG1PJ4f64VBVXofcrD/8t0I6PplmsubiUAjmRel1ksR7XHDUulhLikyt768a0oBfPYgAFUfPipvDYut0Ot8rl5fQ==

webhookUrlstring

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

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app.apollopayment.io/api-gateway/swaps/create' \
  --header 'Content-Type: application/json' \
  --data '{
    "advancedBalanceId": "f9565f73-eb15-4246-9954-169eeb9475fc",
    "clientId": "merchant_unique_id",
    "addressFromId": "21d8a948-5b69-45b9-8a4d-898be4df18e6",
    "addressToId": "3c436d99-5b52-4b2c-b752-d8b3e9f8ae0e",
    "feeToken": "U2FsdGVkX1/FIpPE+Ch/nGia1sP/OahFtB7gSay76eRVdOej3tVnkzhM/figukozPK8C9KsC6nElUeiPpoJTDUXNzc9wl0P0a1cYNSGMAnUu6VTgaJmV9saymORGHqCG1PJ4f64VBVXofcrD/8t0I6PplmsubiUAjmRel1ksR7XHDUulhLikyt768a0oBfPYgAFUfPipvDYut0Ot8rl5fQ==",
    "webhookUrl": "https://merchant.domain/webhooks/swap"
  }'

200

200

{
  "success": true,
  "response": {
    "id": "e63e03d1-7128-4482-80b5-cb7ac3773026",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "f9565f73-eb15-4246-9954-169eeb9475fc",
    "addressFromId": "21d8a948-5b69-45b9-8a4d-898be4df18e6",
    "addressToId": "3c436d99-5b52-4b2c-b752-d8b3e9f8ae0e",
    "currencyFrom": "USDT",
    "currencyTo": "USDC",
    "networkFrom": "ethereum",
    "networkTo": "tron",
    "amountFrom": "200",
    "amountTo": "200",
    "price": "1",
    "serviceBlockchainFee": "2",
    "serviceBlockchainFeeUSD": "2",
    "providerBlockchainFee": "2",
    "providerBlockchainFeeUSD": "2",
    "serviceFee": "2",
    "serviceFeeUSD": "2",
    "webhookUrl": "https://merchant.domain/webhooks/swap",
    "createdAt": "2024-12-26T08:21:53.364Z",
    "status": "PENDING",
    "rejectMessage": "null",
    "serviceBlockchainFeeSource": "ADVANCE",
    "providerBlockchainFeeSource": "AMOUNT",
    "serviceFeeSource": "ADVANCE"
  }
}