# 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="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-7ed5d519b4e7aa6607b418dea63f8776e7ca879f%2Fimage.png?alt=media" alt="" width="422"><figcaption></figcaption></figure>

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

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-aca7155c54dbe08dc702975e9e781b3b6ac17894%2Fimage.png?alt=media" 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="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-aa5e8a1d7a54b4c47397b2690f1373816d973f86%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-88c0830a9f9a709211b971323c84e3f352a6d070%2Fimage.png?alt=media" 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** на сумму заявки (при достаточном для выполнения действия балансе).\
![](https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-3d43e5122714e1a5d93a08771b9bdf62b2d2b890%2Fimage.png?alt=media)

\
Пример 2:\
Действие "<mark style="color:red;">**Продать**</mark>", направление обмена **USDT TRC20 на BTC**, в настройках ТД поля "**Код валюты**" и "**Код торговой валюты**" пустые для покупки и продажи, сумма "**Отдаете**".\
Клиент создаёт заявку на получение 0.0012 BTC (\~100 USDT) и оплачивает её. В этот момент на бирже выполнится <mark style="color:green;">**покупка**</mark>**&#x20;BTC** за **USDT** на сумму заявки.\
![](https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-97b9f049f019b8a7d505877854b19470d1d9bcb2%2Fimage.png?alt=media)

\
Пример 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 %}