Подключение биржи и импорт сделок в журнал

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

Коротко

Подключите к Arbiq ключ биржи только на чтение — и ваши сделки станут черновиками в журнале, а начисления фандинга и займа лягут в позиции реальными суммами вместо оценки. Записывать сделку руками больше не нужно: в форме операции вы отмечаете галочками сделки с биржи, из которых она состоит, и количество, цена, комиссия и время подставляются сами.

Поддерживаются Bybit, OKX, Gate, Bitget, MEXC, BingX, Binance, KuCoin, Hyperliquid и Aster. У двух последних вместо ключа кошелёк — про них отдельная статья Подключение DEX.

Подключение

Откройте Биржевые аккаунты — кнопка есть в журнале рядом с «Новая позиция» и в меню профиля.

Диалог биржевых аккаунтов: два подключённых ключа и форма подключения

Создайте на бирже ключ только на чтение. Если биржа умеет ограничение по IP — добавьте

адреса, которые показаны под формой. У OKX и Bitget ключу нужен пароль — введите его в форме.

Укажите дату, с которой загружать историю. Это как дата начала учёта в бухгалтерии: сделки и

начисления раньше неё не импортируются. По умолчанию — месяц назад. Дату можно поменять потом через меню … у аккаунта; следующая синхронизация перечитает историю с новой даты.

Нажмите Подключить. Продукт делает один запрос на чтение: если биржа отказала — вы увидите её

ответ (чаще всего это IP не в списке или неверный пароль ключа), и ключ не сохранится.

У подключённого аккаунта видны первые и последние символы ключа, что ему разрешено по словам биржи (только чтение или торговля — второе журналу не нужно, лучше заменить ключ; ключ с правом вывода не принимается), дата начала истории и работает ли ключ сейчас. Через … его можно перепроверить, поменять дату или удалить. Как хранится ключ — в статье Нужны ли вам ключи от моей биржи.

Какие права выдать ключу

Журналу нужно только чтение сделок и начислений. Ключ с правом вывода не принимается вовсе, ключ с правом торговли подключится, но будет отмечен. Что отмечать на форме создания ключа у биржи:

| площадка | что включить | чего НЕ включать | пароль ключа | |---|---|---|---| | Bybit | Read-Only, область Unified Trading (Contract + Spot) | Wallet, Withdraw | — | | OKX | только Read | Trade, Withdraw | нужен | | Gate | Futures «только чтение», Spot «только чтение» | Wallet, Withdraw | — | | Bitget | Read-only, области Futures и Spot | Transfer, Withdraw | нужен | | MEXC | Futures → Trade → View Order Details; то же для Spot, если торгуете спот | всё в Account, Withdraw, Transfer | — | | BingX | только чтение: Account, Perpetual futures, Spot | торговля, Withdraw | — | | Binance | Enable Reading, Enable Futures | Enable Withdrawals, торговля | — | | KuCoin | General только чтение; фьючерсы и спот — чтение | Withdrawal, Transfer | нужен | | Hyperliquid, Aster | кошелёк вместо ключа, см. Подключение DEX | — | — |

Два замечания к таблице. У MEXC ключ живёт 90 дней, если не привязать IP, — привяжите. У Binance спотовые сделки грузятся только по инструментам, которые уже есть в журнале.

Те же подсказки показываются в форме подключения под выбранной биржей. Если биржа умеет ограничение по IP, добавь адреса из формы.

Синхронизация

История подтягивается сама каждые 15 минут и по кнопке с именем биржи в разделе Черновики с бирж. Кнопка запускает чтение в фоне — при первом подключении с глубокой датой это может занять минуты — и, когда оно закончится, покажет, сколько новых черновиков появилось.

Каждый проход читает только то, что появилось после предыдущего, с небольшим перекрытием. Запись с биржи никогда не дублируется: у неё есть свой номер, и второй раз она не загрузится. Скрытые вами черновики тоже не возвращаются.

Биржи хранят историю не бесконечно: Bybit отдаёт около двух лет, OKX, Bitget, MEXC и BingX — около трёх месяцев. Более ранняя дата начала не даст больше данных.

Черновики

Под открытыми позициями появляется раздел Черновики с бирж: время, площадка, символ биржи, сторона (покупка или продажа), количество, цена и комиссия — в долларах, а если биржа списала её в другой монете, то в ней с пометкой.

Раздел черновиков с бирж со сделками, ждущими операции

Черновик ждёт, пока вы не соберёте из него операцию. Ненужный можно скрыть — он уйдёт из списка и не вернётся при следующей синхронизации; Показать скрытые возвращает список, а Вернуть — сам черновик.

Операция из сделок биржи

В форме операции — новой позиции, входа или выхода — под каждой ногой показаны черновики её площадки и инструмента в нужном направлении: вход покупает лонг и продаёт шорт, выход наоборот.

Форма операции: под каждой ногой отмечены сделки биржи, поля заполнены

Отметьте сделки, из которых состоит операция. Их может быть несколько — количество сложится, цена

станет средневзвешенной, комиссии сложатся в долларах, время возьмётся у последней сделки.

Поля количества, цены и комиссии при этом закрываются — это слова биржи. Плечо остаётся вашим:

биржа его в сделке не сообщает. Снимите галочку — поля снова ваши.

Под полем цены каждой ноги видна текущая котировка той стороны стакана, которой торгует

операция: аск для покупки, бид для продажи. Клик по ней ставит цену в поле, если нога не собрана из сделок биржи.

Отмеченные сделки привязываются к операции: если операцию поправить с другим набором, лишние

вернутся в черновики; если удалить — вернутся все.

Фандинг и займ

Пока к площадке ноги не подключён ключ, фандинг перпа и часовой процент займа считаются по нашим рядам ставок. Когда ключ подключён, начисления с биржи привязываются к позиции по времени и заменяют оценку по этой ноге целиком — в панели позиции это те же строки, но суммами биржи.

Добавление, правка или удаление операции пересчитывают фандинг и займ позиции заново: окно позиции сдвинулось, и начисления раскладываются по позициям ещё раз.

Если что-то не так

Аккаунт помечен ошибкой — биржа отказала на синхронизации, её ответ виден при наведении. Чаще

всего ключ истёк или изменился список IP. Перепроверьте через …, после удачной синхронизации аккаунт снова рабочий.

Черновиков нет, хотя сделки были — проверьте дату начала истории: раньше неё не грузим. У Gate

и MEXC сделки на споте читаются только по инструментам, которые уже есть в журнале.

Комиссия в другой монете — биржа списала её, например, в базовом активе; в долларах мы

переводим по цене сделки, а если не смогли — оставляем сумму в монете, и поле комиссии в форме остаётся вам.