> For the complete documentation index, see [llms.txt](https://premium.gitbook.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://premium.gitbook.io/main/osnovnye-nastroiki/modul-torgovye-deistviya/sozdanie-torgovogo-deistviya/abcex-v-razrabotke.md).

# ABCEx

{% hint style="info" %}
Для обсуждения условий и подключения, свяжитесь с [представителем сервиса](https://t.me/ABCEX_API_support).

**Дисклеймер**: при подключении вашего сайта к тому или иному сервису, пожалуйста, самостоятельно оценивайте возможные риски сотрудничества.
{% endhint %}

{% hint style="danger" %}
Обратите внимание, что ABCEx рассчитывает курс для пары USDT-BTC с учетом маркапа (наценки) в 5% (а также 0.25% для пары USDT-RUB) — за счет этого сервис может гарантировать исполнение ордеров даже при резком изменений курса в момента.

Сделка будет происходить по актуальному курсу в стакане — вы можете рассчитывать объем ордера с учетом вышеуказанных % резерва, чтобы откупалось нужное вам количество валюты.
{% endhint %}

{% hint style="success" %}
[Общая инструкция по настройке параметров торговых действий](https://premium.gitbook.io/main/osnovnye-nastroiki/modul-torgovye-deistviya/sozdanie-torgovogo-deistviya/parametry-torgovykh-deistvii)
{% endhint %}

Зайдите в раздел "**Торговые действия"** ➔ "**Добавить действие**", укажите в поле "**Заголовок**" название для создаваемого торгового действия, в поле "**Модуль**" выберите из выпадающего списка ABCEx, оставьте статус "**Активное действие**" и нажмите на "**Сохранить**".

<figure><img src="/files/5NYtHKlJihhLBw2BgX0K" alt="" width="422"><figcaption></figcaption></figure>

Укажите ваш API-ключ, полученный от представителя биржи (поле "**Домен**" оставьте пустым) и сохраните изменения.

<figure><img src="/files/zEic2nkmmQJRx4rNG6MA" alt=""><figcaption></figcaption></figure>

В модуле можно создать одно из двух действий — "**Продать**" или "**Купить**".

{% hint style="info" %}
Действие "<mark style="color:red;">**Продать**</mark>" подходит в случаях, когда вы хотите конвертировать сумму, эквивалентную сумме полученной от клиента валюту по заявке в стейблкоин USDT (или другую валюту, которая кажется вам подходящей).

Действие "<mark style="color:green;">**Купить**</mark>" подходит в случаях, когда вы не хотите держать резерв выплачиваемой валюты на своих счетах на бирже и планируете осуществлять закупку валюты для выплаты непосредственно при наличии клиента с заявкой на покупку этой валюты у вашего обменника. В этом случае необходимо использовать [модуль для автовыплаты ABCEx](https://premium.gitbook.io/main/osnovnye-nastroiki/merchanty-i-avtovyplaty/avtovyplaty/abcex) для выплаты валюты сразу после её покупки.

Пример: **направление обмена BTC** — **USDT**.\
Если вы хотите <mark style="color:red;">**продать**</mark> эквивалент полученной от клиента по заявке суммы на бирже ABCEx (к примеру, продать BTC, получив USDT) — выберите сумму "**Отдаете**" в настройках ТД для действия "**Продать**" (поля "**Код валюты** и "**Код торговой валюты**" должны быть пустыми или в поле "**Код валюты**" (валюта для продажи) укажите BTC, а в "**Код торговой валюты**" — USDT).\
При срабатывании торгового действия на бирже ABCEx будет выполнена <mark style="color:red;">**продажа**</mark> BTC с вашего баланса и <mark style="color:green;">**покупка**</mark> USDT по биржевому курсу.

Если вы хотите <mark style="color:green;">**купить**</mark> эквивалент отправленной клиенту по заявке суммы на бирже (к примеру, купить BTC, заплатив за него USDT) — выберите сумму "**Отдаете**" в настройках ТД для действия "**Купить**" (поля "**Код валюты** и "**Код торговой валюты**" должны быть пустыми или в поле "**Код валюты**" (валюта для покупки) укажите BTC, в "**Сеть**" выберите BTC, а в "**Код торговой валюты**" укажите USDT).\
При срабатывании торгового действия на бирже ABCEx будет выполнена <mark style="color:green;">**покупка**</mark> BTC с вашего баланса и <mark style="color:red;">**продажа**</mark> USDT по биржевому курсу.
{% endhint %}

<div><figure><img src="/files/3Vkp2R33nsDIog7MzenS" alt=""><figcaption></figcaption></figure> <figure><img src="/files/KkZg2xKKrWsQfRK4sskj" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Примеры работы торговых действий:

Пример 1:\
Действие "<mark style="color:red;">**Продать**</mark>", направление обмена **USDT TRC20 на BTC**, в настройках ТД указаны валюты для покупки ("**Код валюты)** — **USDT** и продажи ("**Код торговой валюты**") — **RUB**, сумма из заявки "**Отдаете**".\
Клиент создаёт заявку на получение 0.0012 BTC (\~100 USDT) и оплачивает её. В этот момент (если в ТД выбран статус выполнения "**После статуса ожидания подтверждения мерчанта)"** на бирже выполнится <mark style="color:red;">**продажа**</mark>**&#x20;USDT** на **RUB** на сумму заявки (при достаточном для выполнения действия балансе).\
![](/files/4HZb2erJkjtjaOr24Hmg)

\
Пример 2:\
Действие "<mark style="color:red;">**Продать**</mark>", направление обмена **USDT TRC20 на BTC**, в настройках ТД поля "**Код валюты**" и "**Код торговой валюты**" пустые для покупки и продажи, сумма "**Отдаете**".\
Клиент создаёт заявку на получение 0.0012 BTC (\~100 USDT) и оплачивает её. В этот момент на бирже выполнится <mark style="color:green;">**покупка**</mark>**&#x20;BTC** за **USDT** на сумму заявки.\
![](/files/hGrULLffrEOUPQyhVsoC)

\
Пример 3:\
Действие "<mark style="color:red;">**Продать**</mark>", направление обмена **BTC** на **USDT TRC20**, в настройках ТД указаны валюты "**Авто**" для покупки и продажи, сумма "**Получаете**".\
Клиент создаёт заявку на получение 100 USDT и оплачивает её. В этот момент на бирже выполнится <mark style="color:green;">**покупка**</mark>**&#x20;BTC** за **USDT** на сумму заявки.\
\
Пример 4:\
Действие "<mark style="color:red;">**Продать**</mark>", направление обмена **USDT TRC20** на **RUB**, в настройках ТД указаны валюты "**Авто**" для покупки и продажи, сумма "**Получаете**".\
Клиент создаёт заявку на получение 8500 RUB (\~100 USDT) и оплачивает её. В этот момент на бирже выполнится <mark style="color:green;">**покупка**</mark>**&#x20;USDT** за **RUB** на сумму заявки.
{% endhint %}

{% hint style="warning" %}
Обратите внимание, что можно создавать действия для ступенчатого обмена одной валюты на другую через промежуточные валюты. Чаще всего, при отсутствии пары **валюта 1** ➔ **валюта 2** на бирже, производится обмен через стейблкоин USDT (TRC20) (**валюта 1** ➔ **USDT** ➔ **валюта 2**), но вы можете использовать и альтернативные варианты.

Для ступенчатого обмена необходимо:

* создать 2 торговых действия: **Продать** (**валюта 1** ➔ **USDT) и Купить (USDT** ➔ **валюта 2**)
* выбрать одни и те же направления обмена и статусы для срабатывания в блоке "**Настройки добавления**" в настройках торговых действий
* установить порядок выполнения действий: 1 — для действия **Продать**, 2 — для действия **Купить.**
  {% endhint %}

Для корректности выполнения торгового действия также важно выбрать пару валют, которая торгуется на бирже ABCEx, в полях "**Код валюты**" и "**Код торговой валюты**". При пустых полях "**Код валюты**" и "**Код торговой валюты**" валюты будут подбираться автоматически (смотрите примеры выше).

{% hint style="danger" %} <mark style="color:red;">**На данный момент доступны валютные пары USDT/RUB и BTC/USDT (и обратные им).**</mark>

При выборе валют, которые не образуют пару — торговое действие гарантированно получит ошибку при попытке выполнения
{% endhint %}
