Краткий обзор

Обзор разделов API биржи ABCEX и краткое описание основных операций.

ABCEX API позволяет торговать на споте и фьючерсах, управлять активами, участвовать в P2P-сделках и подписываться на рыночные данные в реальном времени. Этот раздел даёт обзор основных функций, чтобы вы быстрее сориентировались в документации.

Аутентификация

Доступ к приватным эндпоинтам возможен двумя способами:

• JWT-токен – подходит для веб-клиентов и мобильных приложений. Получается при логине через личный кабинет, передаётся в заголовке Authorization: Bearer <JWT>. Имеет ограниченное время жизни.
• API-ключ – подходит для ботов и серверных интеграций. Выпускается один раз через ЛК (или через REST с JWT + 2FA), запросы подписываются HMAC-SHA256. Подробности — в разделе «Аутентификация».

Публичные эндпоинты (рыночные данные, инструменты, тикеры) доступны без авторизации.

Спотовая торговля

Покупка и продажа криптовалют и фиатных валют по текущему рынку.

• Торговые пары и тикеры – GET /api/v2/exchange/public/asset/instrument/spot/list, GET /api/v2/exchange/public/ticker
• Стакан и свечи – GET /api/v2/exchange/public/orderbook, GET /api/v2/exchange/public/candle
• Создание ордера – POST /api/v2/exchange/client/order/spot
• Управление ордерами – активные, история, отмена одного или массой
• Личные сделки – GET /api/v2/exchange/client/trade/spot/list/my

Поддерживаются типы ордеров limit, market и время действия gtc и ioc. См. раздел «Спот».

Фьючерсная торговля

Бессрочные контракты с кредитным плечом — лонг и шорт по базовому активу.

• Инструменты, риск-тиры, ставки фандинга, mark/index price – раздел «Фьючерсы – Рынок (публичные)»
• Создание ордера – POST /api/v2/exchange/client/order/derivative
• Управление позициями – открыть, закрыть, изменить плечо, тип маржи (isolated/cross), режим (one-way/hedge)
• История закрытых позиций и история ордеров позиций – GET /api/v2/exchange/client/positions/history/closed/positions, GET /api/v2/exchange/client/positions/history/closed/orders

См. раздел «Фьючерсы» и его подразделы.

Аккаунт

Информация по пользователю и его счетам.

• Баланс кошельков – GET /api/v1/accounting/client/report-account/accounts/overview, балансы по всем счетам пользователя:
  • funding – Счёт пополнения
  • unified-trading – Единый торговый счёт (спот + фьючерсы)
  • p2p – Счёт Peer-to-Peer
  • referral-program – Реферальный счёт
  • overdraft – Счёт овердрафта
• История операций – GET /api/v1/wallet/transactions/list/my (с фильтрами по типу, статусу, периоду)
• Торговые комиссии – GET /api/v2/exchange/client/fee/personal
• Реферальная программа – ссылка для приглашения (GET /api/v2/referral-program/client/link) и баланс начислений (GET /api/v2/referral-program/client/reward/{linkId})

См. раздел «Аккаунт».

Активы

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

• Просмотр балансов – GET /api/v1/accounting/client/report-account/accounts/overview (балансы по всем счетам и валютам)
• История транзакций – GET /api/v1/wallet/transactions/list/my (депозиты, выводы, переводы — с фильтрами по типу, статусу, периоду)
• Пополнение – через кассу (POST /api/v1/processing/create-and-submit-fiat-application), активацию кода (POST /api/v1/code/redeem) или крипто-адрес (GET /api/v1/wallet/crypto/address)
• Снятие – через кассу (тот же fiat-application), создание кода (POST /api/v1/code/create-api) или вывод на крипто-кошелёк (POST /api/v1/wallet/create-and-submit-crypto-out)
• Переводы между счетами – POST /api/v1/accounting/client/transfer/account (например, между Funding и Unified Trading)

См. разделы «Аккаунт», «Ввод и вывод», «Переводы».

Переводы между счетами

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

• Список маршрутов – GET /api/v1/accounting/client/transfer/account/transfer-routes/list
• Выполнить перевод – POST /api/v1/accounting/client/transfer/account

См. раздел «Переводы».

Ввод/вывод криптовалюты

• Депозит – GET /api/v1/wallet/crypto/address – получить адрес для пополнения, если он уже выпущен; POST /api/v1/wallet/get-new-crypto-address – сгенерировать новый адрес.
• Вывод – GET /api/v2/withdrawals/currencies – доступные сети для вывода; POST /api/v1/wallet/create-and-submit-crypto-out – создать заявку на вывод; DELETE /api/v1/wallet/create-crypto-out/{transactionId} – отменить заявку до начала обработки.
• Отслеживание статуса – GET /api/v1/wallet/transactions/list/my.

Сети и активы – GET /api/v1/currency-network/list, GET /api/v2/exchange/client/asset/list.

См. раздел «Ввод и вывод».

Ввод/вывод фиата через кассу

Ввод фиата через кассу на биржу включает следующие шаги:Создание заявки на пополнение – необходимо создать заявку на ввод или вывод фиата через кассу:

• Заявку можно создать в статусе "Черновик" – такая заявка не переходит в обработку сотрудниками биржи, метод POST /api/v1/processing/fiat-application
• В случае, если необходимо подтвердить черновик заявки, необходимо отправить запрос PATCH /api/v1/processing/fiat-application
• Заявку можно создать и сразу подтвердить – такая заявка будет сразу в статусе "На рассмотрении" и переходит в обработку сотрудниками биржи, метод POST /api/v1/processing/create-and-submit-fiat-application
• Отслеживание статуса выполнения заявки – необходимо отправлять запрос GET /api/v1/wallet/transactions/list/myЕсли заявка больше не актуальна и ее необходимо удалить – DELETE /api/v1/processing/fiat-application

Статусная модель заявки:

created – Черновик, такая заявка не переходит в обработку сотрудниками биржи

submitted – Заявка ожидает взятия в обработку

processing – Заявка находится в обработке сотрудником биржи

rejected – Заявка отклонена сотрудником биржи

failed – Ошибка при выполнении заявки

canceled – Заявка отменена

completed – Заявка выполнена

Коды (ваучеры)

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

• Создать код – POST /api/v1/code/create-api
• Активировать (получить средства) код – POST /api/v1/code/redeem
• Список своих кодов – GET /api/v1/code/my (фильтр по статусу: активирован/неактивирован)
• Полная информация о коде – POST /api/v1/code/full

См. раздел «Ввод и вывод» → «Коды».

Курьеры

Функциональность курьеров позволяет осуществлять ввод/вывод фиата с помощью доверенных лиц.

Данная функциональность доступна только по запросу.

Овердрафты (маржинальный спот)

Торговля на споте на заёмные средства. Функциональность доступна по запросу.

• Статус овердрафта – GET /api/v2/credit/client/overdraft/me
• Информация о займах – GET /api/v2/credit/client/overdraft/loan
• Расчёт комиссии – GET /api/v2/credit/client/overdraft/credit-fee
• Документы (соглашения) – GET /api/v2/credit/client/overdraft/documents
• Погашение – POST /api/v2/credit/client/overdraft/pay

См. раздел «Овердрафты».

P2P торговля

Прямой обмен криптовалюты на фиат между пользователями через объявления.

• Объявления – список, просмотр, создание/редактирование, активация/деактивация, удаление. Ограничение: до 3 активных объявлений на тип (покупка/продажа) на каждой торговой паре.
• Сделки – отклик на объявление, подтверждение начала, оплата, подтверждение получения оплаты, отмена, апелляция (диспут), таймеры на каждом этапе. Максимум 5 одновременных активных сделок на торговую пару.
• Профиль – пользовательская информация и переводы между P2P-счетами.
• Чат – переписка по объявлению/сделке (через Socket.IO).

Статусы сделки: open:wait-confirm, open, send-payment-document, dispute:open, complete, cancel. См. раздел «P2P».

WebSocket

Получение рыночных данных и приватной информации в реальном времени без постоянных HTTP-запросов.

• Exchange WebSocket (wss://hub.abcex.io/websocket/exchange) – спот и фьючерсы. Публичные каналы (стакан, сделки, тикеры, свечи, volume-ratio) доступны без авторизации; приватные (балансы, ордера, позиции, свои сделки) — после auth-сообщения.
• P2P WebSocket – Socket.IO v4, передача токена в URL-параметре.

Поддерживаются оба формата авторизации: JWT-токен и API-ключ (HMAC-подпись). Поддержание соединения — клиент шлёт {"method":"ping"} каждые 20–25 секунд, сервер отвечает {"pong": <ms>}.

См. раздел «WebSocket API».

Архив

Раздел содержит legacy-эндпоинты v1 — устаревшие методы, оставленные для обратной совместимости. Не используйте их в новых интеграциях; в описании каждого указан актуальный аналог из v2.

См. раздел «Архив».