Creating a cross-chain translation
The method allows you to create a cross-chain transfer. Cross-chain transfer allows you to transfer your assets from one network to 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
The body of the request to create a cross-chain transfer
clientIdstringOptionalExample:
Unique transaction identifier in the merchant system, to prevent duplication of creation
merchant_unique_id
addressFromIdstringRequiredExample:
Identifier of the outgoing address in the system, in the specified coin and network when creating the commission token. The specified amount will be debited from this address
258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be
addressToIdstringRequiredExample:
Identifier of the destination address in the system where the coins should be delivered
f2d7f1a0-2a43-4975-89a9-5c598447699e
feeTokenstringRequiredExample:
Commission Token
U2FsdGVkX1/q7wJP4zatjl/52yKfIkWGikSPzjnRIhpBkyMwhX6A26VxzuXfN1ooEOne+Nk3gfqg4tN3DE4WF3qkQIDTEjqEP7sx7egHyv02VU3i0QPrbPhVB8F4gHxElJpdtV79+XkGBmGYrREEWh/9c1pqRDL/sgIghqYvBPKNOuRpw+sU+VEPhX0MUub4qWYhYGaNqHhD4svWSGz9jon6EE8l4uQbBRwri3MVbQ0=
webhookUrlstringOptionalExample:
URL address for operation status notification
https://merchant.domain/webhooks/bridge
Responses
200Success
application/json
post
POST /api-gateway/bridge/create HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 446
{
"clientId": "merchant_unique_id",
"addressFromId": "258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be",
"addressToId": "f2d7f1a0-2a43-4975-89a9-5c598447699e",
"feeToken": "U2FsdGVkX1/q7wJP4zatjl/52yKfIkWGikSPzjnRIhpBkyMwhX6A26VxzuXfN1ooEOne+Nk3gfqg4tN3DE4WF3qkQIDTEjqEP7sx7egHyv02VU3i0QPrbPhVB8F4gHxElJpdtV79+XkGBmGYrREEWh/9c1pqRDL/sgIghqYvBPKNOuRpw+sU+VEPhX0MUub4qWYhYGaNqHhD4svWSGz9jon6EE8l4uQbBRwri3MVbQ0=",
"webhookUrl": "https://merchant.domain/webhooks/bridge"
}
200Success
{
"success": true,
"response": {
"id": "1a6dce87-3b34-480b-8055-51a821aeb5ea",
"clientId": "merchant_unique_id",
"currency": "USDT",
"networkFrom": "ethereum",
"networkTo": "tron",
"status": "PENDING",
"rejectMessage": null,
"amount": "200",
"amountUSD": "200",
"blockchainFee": "2",
"blockchainFeeUSD": "2.12",
"serviceFeeUSD": "0.50",
"webhookUrl": "https://merchant.domain/webhooks/bridge",
"createdAt": "2025-06-09T13:18:11.527Z"
}
}
Last updated