Создание авто-обмена

Метод создает запрос на авто-обмен

На создание распространяются лимиты сумм:

• сумма должна быть больше $20 в эквиваленте

• сумма должна быть в два раза больше комиссии сети конечной монеты/сети (см. метод получения доступных монет)

Описание параметров запроса

Параметр	Тип	Обязательно	Описание
address	string	yes	Адрес назначения
currency	string	yes	Монета к получению
network	string	yes	Сеть к получению
amountFrom	string	no	Сумма, которую хотите поменять и отправить
amountTo	string	no	Сумма, которую хотите получить
feeInAmount	boolean	no	Закладывать комиссию сети в сумму обмена
webhookUrl	string	no	URL для отправки уведомлений при изменении статуса

Обязательно надо отправить один из параметров: amountFrom или amountTo При указании двух параметров приоритет будет иметь amountFrom

Закладывать комиссию сети в сумму обмена

Указывая параметр feeInAmount в значении true с адреса будет списана указанная сумма + комиссия сети

• Если указывате amountFrom - возможно проскальзывание конечной суммы amountTo (может отличаться от указаной после запроса создания)

• Если указываете amountTo - будет заблокирована расчетная сумма списания с адреса + процент для покрытия страховки проскальзывания. После завершения обмена сумма будет откорректирована, до той, которая была израсходована для проведения обмена. Возможно небольшое проскальзывание (≈ 0.1%) конечной суммы из-за наложения фильтров обмена на сумму к получению

Описание параметров ответа

Параметр	Тип	Описание
id	string	Идентификатор авто-обмена
organizationId	string	Идентификатор организации
status	enum	Статус
currencyFrom	string	Исходящая монета адреса выбранного для проведения авто-обменов
networkFrom	string	Исходящая сеть адреса выбранного для проведения авто-обменов
currencyTo	string	Конечная монета, которая будет отправлена клиенту
networkTo	string	Конечная сеть, которая будет отправлена клиенту
amountFrom	string	Сумма потраченная для проведения операции
amountFromUSD	string	Сумма потраченная для проведения операции в пересчете к USD
amountTo	string	Конечная сумма после обмена
amountToUSD	string	Конечная сумма после обмена в пересчете к USD
amountToReceive	string	Сумма, которую получит клиент
rate	string	Курс обмена
blockchainFeeFrom	string	Комиссия сети за отправку монет провайдеру для совершения обмена
blockchainFeeFromUSD	string	Комиссия сети за отправку монет провайдеру для совершения обмена в пересчете к USD
blockchainFeeTo	string	Комиссия сети за отправку монет от провайдера на адрес клиента
blockchainFeeToUSD	string	Комиссия сети за отправку монет от провайдера на адрес клиента в пересчете к USD
serviceFee	string	Комиссия сервиса за проведение операции
webhookUrl	string	URL для отправки уведомления об изменении статуса
createdAt	string	Дата создания авто-обмена
updatedAt	string	Дата последнего обновления изменения

Статусы:

Статус	Описание
PENDING	В обработке
WITHDRAWING	Ожидание отправки на конечный адрес
PROCESSED	Успешно
REJECTED	Отклонен
ERROR	Ошибка при обработке

Создание авто-обмена

post

Header parameters

x-api-public-keystringOptional

Публичный API-ключ

x-api-signaturestringOptional

Подпись тела запроса приватным API-ключем

Content-typestringOptional

Тип тела запроса

Example: application/json

Body

addressstringRequired

Адрес для получения

Example: 1CGuTUAx7icKniPVKGiyiT7QLycpkxULLP

currencystringRequired

Монета, которую хотите получить

Example: BTC

networkstringRequired

Сеть, в которой хотите получить монеты

Example: bitcoin

amountFromstringOptional

Исходящая сумма

Example: 1000

amountTostringOptional

Конечная сумма

Example: 0.1

feeInAmountbooleanOptional

Включать комиссию сети в сумму к обмену, при указании данного параметра amountTo будет равняться сумме, которую получить адрес

webhookUrlstringOptional

URL для отправки уведомления об изменении статуса

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

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/auto-swaps/create HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "address": "1CGuTUAx7icKniPVKGiyiT7QLycpkxULLP",
  "currency": "BTC",
  "network": "bitcoin",
  "amountFrom": "1000",
  "amountTo": "0.1",
  "feeInAmount": true,
  "webhookUrl": "https://merchant.domain/webhooks/..."
}

200Success

{
  "success": true,
  "response": {
    "id": "3bd92a32-54f3-4cfa-abb4-291114af1a69",
    "organizationId": "bce675ec-9db2-4f62-91d0-4d1b670540aa",
    "status": "PENDING",
    "message": null,
    "addressRiskLevel": "Low",
    "currencyFrom": "USDT",
    "networkFrom": "bsc",
    "currencyTo": "BTC",
    "networkTo": "bitcoin",
    "amountFrom": "1000",
    "amountFromUSD": "1000",
    "amountTo": "0.1",
    "amountToUSD": "990",
    "amountToReceive": "0.999",
    "rate": "10000",
    "blockchainFeeFrom": "0.34",
    "blockchainFeeFromUSD": "0.34",
    "blockchainFeeTo": "0.001",
    "blockchainFeeToUSD": "10",
    "serviceFee": "10",
    "webhookUrl": "https://merchant.domain/webhooks/...",
    "createdAt": "2024-12-26T08:21:33.194Z",
    "updatedAt": "2024-12-26T08:21:33.194Z"
  }
}