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

Creating a cross-chain translation

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

application/json

The body of the request to create a cross-chain transfer

clientIdstringOptional

Unique transaction identifier in the merchant system, to prevent duplication of creation

Example: merchant_unique_id

addressFromIdstringRequired

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

Example: 258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be

addressToIdstringRequired

Identifier of the destination address in the system where the coins should be delivered

Example: f2d7f1a0-2a43-4975-89a9-5c598447699e

feeTokenstringRequired

Commission Token

Example: U2FsdGVkX1/q7wJP4zatjl/52yKfIkWGikSPzjnRIhpBkyMwhX6A26VxzuXfN1ooEOne+Nk3gfqg4tN3DE4WF3qkQIDTEjqEP7sx7egHyv02VU3i0QPrbPhVB8F4gHxElJpdtV79+XkGBmGYrREEWh/9c1pqRDL/sgIghqYvBPKNOuRpw+sU+VEPhX0MUub4qWYhYGaNqHhD4svWSGz9jon6EE8l4uQbBRwri3MVbQ0=

webhookUrlstringOptional

URL address for operation status notification

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

Responses

200Success

application/json

post

/api-gateway/bridge/create

HTTPcURLJavaScriptPython

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"
  }
}