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
Header parameters
x-api-public-keystringOptional
Public API-key
x-api-signaturestringOptional
Signing the request body with a private API-key
Content-typestringOptionalExample:
Request content type
application/json
Body
clientIdstringOptionalExample:
Unique exchange identifier in the merchant system (to prevent duplicate requests)
merchant_unique_id
addressFromIdstringRequiredExample:
Identifier of the outgoing address from which the specified amount will be debited
258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be
addressToIdstringRequiredExample:
Identifier of the destination address where the coins will be credited after the swap
3d22de20-3fff-4025-bd1a-8a7333aed01b
feeTokenstringRequiredExample:
Commission Token
U2FsdGVkX1/HkixIWxE4ktwUlqmkake0EghgpPQ3ZUY8beJ3jFfSsNTHc8CJ+HtT2l42Vf3aczU2EF1am/ziHL/6knjiJhGu0nsSFSBKtz3mMnT5kQll1AtBa8hEHMtYS9f8TwcvEm8F++6g+zYwyjhUzh0wEwRrl53SkRiGERO7YGYpQv2anTUYvVQbKogM+cXRK9yAbkdkNzhvdsT/yg==
webhookUrlstringOptionalExample:
URL address for notifying about the change in the status of the swap operation
https://merchant.domain/webhooks/swap
Responses
200Success
application/json
post
POST /api-gateway/swaps/create HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 424
{
"clientId": "merchant_unique_id",
"addressFromId": "258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be",
"addressToId": "3d22de20-3fff-4025-bd1a-8a7333aed01b",
"feeToken": "U2FsdGVkX1/HkixIWxE4ktwUlqmkake0EghgpPQ3ZUY8beJ3jFfSsNTHc8CJ+HtT2l42Vf3aczU2EF1am/ziHL/6knjiJhGu0nsSFSBKtz3mMnT5kQll1AtBa8hEHMtYS9f8TwcvEm8F++6g+zYwyjhUzh0wEwRrl53SkRiGERO7YGYpQv2anTUYvVQbKogM+cXRK9yAbkdkNzhvdsT/yg==",
"webhookUrl": "https://merchant.domain/webhooks/swap"
}
200Success
{
"success": true,
"response": {
"id": "5bf975e9-7382-4c12-b41d-9bb5ea183ed7",
"clientId": "merchant_unique_id",
"addressFromId": "258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be",
"addressToId": "3d22de20-3fff-4025-bd1a-8a7333aed01b",
"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-06-09T13:18:11.529Z"
}
}
Last updated