Конвертация и перевод средств между различными сетями (Мост)

Конвертация Coin/Coin

Конвертация на сумму amountIn из валюты assetCodeIn в валюту assetCodeOut. Система поддерживает два режима приоритета:

• exchangePriority: "in" - фиксируется сумма входа (amountIn)

• exchangePriority: "out" - фиксируется сумма выхода (amountOut)

Правила валидации полей (важно):

• Если exchangePriority = "in", поле amountIn обязательно, а amountOut вычисляется автоматически по персональному курсу мерчанта.

• Если exchangePriority = "out", поле amountOut обязательно, а amountIn рассчитывается системой.

• Нельзя указывать оба поля одновременно как фиксированные, приоритет определяет, какое из них фиксируется вручную, а какое рассчитывается.

Курсы и тарифы

Курс определяется индивидуально по тарифу, установленному мерчанту. Все расчёты производятся системой в момент проведения заявки.

Создание обмена

post

Конвертация на сумму amountIn в валюте assetCodeIn в валюту assetCodeOut. Система поддерживает два режима приоритета: exchangePriority: "in" - фиксируется сумма входа (amountIn) exchangePriority: "out" - фиксируется сумма выхода (amountOut)

Header parameters

x-api-keystringRequired

Body

application/json

assetCodeInstringRequired

Ассет на входе в обмен

Example: USDT

amountInnumberOptional

Обмениваемая сумма (обязательно если exchangePriority=in)

Example: 10

assetCodeOutstringRequired

Ассет на выходе

Example: USDT

amountOutnumberOptional

Ожидаемая сумма (обязательно если exchangePriority=out)

Example: 10

commentstringOptional

Комментарий к обмену. Опциональное поле

Example: Хеджирование за 07.2023

exchangePrioritystringOptional

Приоритет обмена (по дефолту "in")

Example: in

idempotencyKeystring · max: 255Optional

Ключ идемпотентности для предотвращения дублирования заявок при сетевых разрывах и состоянии гонки. Должен быть уникальным для каждого мерчанта.

Example: unique-request-id-12345

Responses

200

Успешное создание обмена

application/json

400

Некорректный запрос

application/json

401

Необходимо авторизоваться для запроса

application/json

403

Недостаточно прав

application/json

500

Системная ошибка

application/json

post

/api/v1/integration/orders/exchange

HTTPcURLJavaScriptPython

POST /api/v1/integration/orders/exchange HTTP/1.1
Host: 
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 190

{
  "assetCodeIn": "USDT",
  "amountIn": 10,
  "assetCodeOut": "USDT",
  "amountOut": 10,
  "comment": "Хеджирование за 07.2023",
  "exchangePriority": "in",
  "idempotencyKey": "unique-request-id-12345"
}

{
  "message": "ok",
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2026-01-26T19:17:13.872Z",
    "updatedAt": "2026-01-26T19:17:13.872Z",
    "deletedAt": "2026-01-26T19:17:13.872Z",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "merchantId": 6547,
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDTERC20",
    "currencyOutCode": "USDT",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "isDone": false,
    "apiMode": "ui",
    "risk": "24",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesMemoTag": "80576",
    "requisitesMemoTagIn": "80576",
    "requisitesMemoTagOut": "80576",
    "billingTag": "[e-mail]",
    "requisitesQrCode": "https://example.com/img-name.png",
    "assetInCode": "BTC",
    "assetOutCode": "USDT",
    "networkInCode": "ETH",
    "networkOutCode": "NEAR",
    "balanceAfter": "44",
    "balanceAccountAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "refundTxId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2026-01-26T19:17:13.872Z",
    "isImPayed": false,
    "isBayerPaysService": false,
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "requisitesInUrl": "https://example.com/requisites",
    "orderCurrencyType": "crypto",
    "paymentMethod": "sbp",
    "providerCode": "123123123123",
    "providerAliasCode": "text",
    "paymentSettingsName": "text",
    "providerName": "text",
    "amlReportExists": false,
    "minFeeTriggerAmount": "500",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "signature": "f9ced1e5a6fa7c5dc7ac5453c31eccef1f821153db9dc8f7eb81b28503d9772",
    "warningCode": "101",
    "giftCode": "4BAF32"
  },
  "count": 1
}

Конвертация и перевод средств между различными сетями Coin/Coin

Создание заявки на Валюта -> Валюта (мост)

post

Заявка на конвертацию и перевод средств между различными сетями. Процесс включает три этапа: Получение -> Обмен -> Вывод. Например, при переводе USDTERC20 в BNBBEP20: 1. Предоставляется адрес для внесения USDTERC20 (fromCurrencyCode) в сети Ethereum 2. Полученные средства конвертируются в BNB 3. BNB выводятся как BNBBEP20 (toCurrencyCode) на указанный адрес (recipient) в сети Binance Smart Chain

  Важно: Сумма перевода (amount) указывается в toCurrencyCode.
 
  Совет: Для оценки суммы fromCurrencyCode можно воспользоваться методом "orders/estimate-in".

Header parameters

x-api-keystringRequired

Body

application/json

amountstringRequired

Сумма выхода

Example: 10

toCurrencyCodestringRequired

Валюта получения (с сетью)

Example: USDTMATIC

recipientstringRequired

Реципиент (адрес)

Example: 0x0000000000000000000000000000000000000000

requisitesMemoTagstringOptional

Мемо тег (для XRP, TON и т.д.)

Example: 80576

callbackUrlstring · min: 5Optional

Callback url для отправки хуков

Example: https://api.myip.com

commentstringOptional

Комментарий к переводу. Опциональное поле

Example: Оплата сервера за 07.2023

idempotencyKeystring · max: 255Optional

Ключ идемпотентности для предотвращения дублирования заявок при сетевых разрывах и состоянии гонки. Должен быть уникальным для каждого мерчанта.

Example: unique-request-id-12345

detailsobjectOptional

Детали для фиатных выводов

Example: {"method":"card"}

fromCurrencyCodestringRequired

Входная валюта

Example: BTC

Responses

200

Успешное создание СТС заявки

application/json

400

Некорректный запрос

application/json

401

Необходимо авторизоваться для запроса

application/json

403

Недостаточно прав

application/json

500

Системная ошибка

application/json

post

/api/v1/integration/orders/currency-to-currency

HTTPcURLJavaScriptPython

POST /api/v1/integration/orders/currency-to-currency HTTP/1.1
Host: 
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 319

{
  "amount": 10,
  "toCurrencyCode": "USDTMATIC",
  "recipient": "0x0000000000000000000000000000000000000000",
  "requisitesMemoTag": "80576",
  "callbackUrl": "https://api.myip.com",
  "comment": "Оплата сервера за 07.2023",
  "idempotencyKey": "unique-request-id-12345",
  "details": "{\"method\":\"card\"}",
  "fromCurrencyCode": "BTC"
}

{
  "message": "ok",
  "data": {
    "id": 1,
    "uid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "createdAt": "2026-01-26T19:17:13.872Z",
    "updatedAt": "2026-01-26T19:17:13.872Z",
    "deletedAt": "2026-01-26T19:17:13.872Z",
    "serviceCommission": "0.565",
    "netCommission": "0.565",
    "comment": "Комментарий",
    "publicComment": "Публичный комментарий",
    "merchantUid": "3422b448-2460-4fd2-9183-8000de6f8343",
    "merchantName": "Тестовый мерчант",
    "merchantId": 6547,
    "type": "invoice",
    "status": "created",
    "invoiceCurrencyCode": "BTC",
    "currencyInCode": "USDTERC20",
    "currencyOutCode": "USDT",
    "invoiceAmount": "10.2334",
    "amountInExpected": "43.11",
    "amountInFact": "44",
    "amountOutExpected": "43.11,",
    "amountOutFact": "44",
    "hedgeRate": "44",
    "isDone": false,
    "apiMode": "ui",
    "risk": "24",
    "requisites": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesIn": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesOut": "0xD72901047ffd7Ad0f581016E6B8cF563E02E44bB",
    "requisitesMemoTag": "80576",
    "requisitesMemoTagIn": "80576",
    "requisitesMemoTagOut": "80576",
    "billingTag": "[e-mail]",
    "requisitesQrCode": "https://example.com/img-name.png",
    "assetInCode": "BTC",
    "assetOutCode": "USDT",
    "networkInCode": "ETH",
    "networkOutCode": "NEAR",
    "balanceAfter": "44",
    "balanceAccountAfter": "44",
    "callbackUrl": "https://example/myCallback",
    "invoicePublicUrl": "https://example/myInvoice",
    "txId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "refundTxId": "afda7a230080dee2119ce5d0a4a83980071eef6e5b14f1dc9ec7e510e63983fd",
    "expirationTime": "2026-01-26T19:17:13.872Z",
    "isImPayed": false,
    "isBayerPaysService": false,
    "serviceFeeCurrencyCode": "USDT",
    "netFeeCurrencyCode": "USDT",
    "requisitesInUrl": "https://example.com/requisites",
    "orderCurrencyType": "crypto",
    "paymentMethod": "sbp",
    "providerCode": "123123123123",
    "providerAliasCode": "text",
    "paymentSettingsName": "text",
    "providerName": "text",
    "amlReportExists": false,
    "minFeeTriggerAmount": "500",
    "paymentTiming": "onTime",
    "amountValidity": "valid",
    "signature": "f9ced1e5a6fa7c5dc7ac5453c31eccef1f821153db9dc8f7eb81b28503d9772",
    "warningCode": "101",
    "giftCode": "4BAF32"
  },
  "count": 1
}