Что Arb.OS забирает с биржи по API, а что нет

Что Arb.OS забирает с биржи по read-only API: восемь лент данных, полная таблица покрытия по 11 биржам и почему где-то стоит прочерк.

📅 Актуально на: август 2026 года

Подключение биржи по API обычно описывают одной фразой: «сделки подтянутся сами». На деле сделки — это меньшая часть того, что нужно журналу. Чтобы цифры сходились, нужно знать ещё и сколько денег лежит на бирже, что вы вводили и выводили, что заработали на Earn и сколько вернулось реферальными.

Arb.OS забирает восемь видов данных с каждой подключённой биржи. Ниже — что это за данные, у кого они есть, а у кого их получить нельзя, и что с этим делать.

Восемь лент, а не одна

Спот — история сделок на спотовом рынке.
Фьючерсы — история сделок с бессрочными контрактами и открытые позиции.
Балансы — сколько и чего лежит по всем кошелькам биржи: спот, фьючерсный, funding, Earn.
Депозиты и выводы — ввод и вывод средств с биржи в блокчейн и обратно.
Переводы — перекладывание денег между кошельками внутри самой биржи: спот ↔ фьючерсы ↔ funding.
Earn — начисления по стейкингу, сейвингам и гибким продуктам, а также раздачи и airdrop'ы.
Реферальные — возврат части комиссий за приглашённых и собственный ребейт.
Конвертации — обмены через Convert и сметание мелких остатков («пыли»).

Первые две ленты дают журнал сделок. Остальные шесть отвечают на вопрос, почему баланс на бирже не совпадает с суммой прибыли по сделкам. Без них любой журнал рано или поздно расходится с реальностью, и разницу приходится списывать на «где-то потерялось».

Что и с какой биржи забирается

По API работают 11 бирж из 26, которые знает Arb.OS. Вот полная картина:

Биржа	Спот	Фьюч.	Балансы	Ввод/вывод	Переводы	Earn	Реф.	Конверт.
Binance	✓	✓	✓	✓	✓	✓	✓	✓
OKX	✓	✓	✓	✓	✓	✓	✓	✓
Gate	✓	✓	✓	✓	✓	✓	✓	✓
Bybit	✓	✓	✓	✓	✓	✓	—	✓
Bitget	✓	✓	✓	✓	✓	✓	—	✓
CoinEx	✓	✓	✓	✓	✓	✓	—	✓
KuCoin	✓	✓	✓	✓	✓	✓	✓	—
MEXC	✓	✓	✓	✓	✓	—	✓	✓
BingX	✓	✓	✓	✓	✓	—	✓	—
Hyperliquid	✓	✓	✓	✓	✓	✓	✓	нет продукта
Aster	нет продукта	✓	✓	✓	нет продукта	нет продукта	—	✓

Галочка — данные забираются автоматически. Прочерк — нет, и это придётся вносить руками. «Нет продукта» — у площадки такого просто не существует: у perp-DEX не бывает Earn, а у Aster нет спота.

Эта же таблица живёт внутри приложения на странице API-ключи — там она всегда актуальна, потому что строится из того же реестра, что и сама синхронизация. Если биржа перестанет отдавать ленту или, наоборот, начнёт, таблица изменится вместе с кодом.

Почему где-то прочерк

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

Биржа не отдаёт эту историю по API. MEXC и BingX не публикуют историю начислений Earn: доход виден в интерфейсе, но получить его программно нельзя. То же с конвертациями у BingX.

История доступна, но не обычному ключу. Bitget, Bybit и CoinEx отдают реферальные начисления только партнёрским (affiliate или broker) аккаунтам с отдельными правами. У CoinEx эндпоинт на обычном ключе просто отвечает ошибкой. KuCoin показывает историю Convert только ключу с правом на спотовую торговлю — а Arb.OS такие права не запрашивает принципиально, поэтому эта лента остаётся закрытой.

Продукта нет. Aster — perp-DEX: спота, внутренних переводов и Earn там нет по устройству площадки. У Hyperliquid нет Convert.

Оговорки, о которых лучше знать заранее

Даже там, где стоит галочка, у биржи бывают свои условия. Самые заметные:

Глубина истории ограничена. Bitget отдаёт переводы между кошельками только за 90 дней, KuCoin — реферальные примерно за 35 дней, Gate хранит фьючерсные ребейты 180 дней. Всё, что старше, получить уже нельзя — ни нами, ни вами.
Первая загрузка бывает долгой. Bybit ограничивает 60 запросов в минуту, поэтому первый сбор переводов занимает минуту-две. KuCoin отдаёт леджер окнами по 24 часа и на первом синке забирает 90 дней — это несколько минут. Дальше обновления идут быстро.
Субаккаунты не учитываются. Переводы между суб-аккаунтами не видны у Bybit, Gate и OKX — биржи не показывают их обычному ключу основного аккаунта.
Не всякий перевод — то, чем кажется. У Aster перекладывание денег между perp и спотом отражается как депозит и вывод фьючерсного кошелька, а комиссию сети площадка не отдаёт вовсе.

Каждая такая оговорка подписана прямо в таблице на странице API-ключей — наводите на пометку рядом с галочкой.

Остальные 15 бирж — ручной режим

Apex, Bitvenus, BTSE, Coinbase, CoinCatch, HTX, Jupiter, Kraken, LBank, Lighter, Ourbit, Paradex, Phemex, Poloniex и XT доступны в Arb.OS только для ручного учёта: их можно выбрать в сделке, указать комиссии и вести журнал, но автоматической синхронизации по ним нет.

Ручной ввод сделок в Arb.OS не ограничен тарифом — вести журнал по любой из 26 площадок можно бесплатно и без лимита на количество сделок.

Что это значит на практике

Выбирая, какую биржу подключать первой, смотрите не только на строку «спот и фьючерсы» — она заполнена почти у всех. Разница между площадками начинается правее.

Если вы активно пользуетесь Earn, MEXC и BingX потребуют ручного учёта начислений — иначе доход просто не появится в журнале, а капитал будет расти «сам по себе», без объяснения. Если для вас существенны реферальные возвраты, обратите внимание, что Bitget, Bybit и CoinEx их не отдадут.

И обратный случай: Binance, OKX и Gate закрывают все восемь лент полностью. Подключив любую из них, вы получаете журнал, который сходится с биржей без ручных правок.