API AsterDEX: Полное руководство для разработчиков

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

Введение в API AsterDEX

API AsterDEX предоставляет прямой доступ к нашему высокопроизводительному механизму сопоставления, позволяя трейдерам и разработчикам обойти стандартный пользовательский интерфейс. Это открывает безграничные возможности для создания сложных торговых алгоритмов, арбитражных ботов и интеграции рыночных данных в реальном времени.

Наш API спроектирован для максимальной точности и скорости, предоставляя вам инструменты для перехода от реактивной торговли к проактивному управлению вашими активами в экосистеме децентрализованных финансов.

Безопасность API: Ваш главный приоритет

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

Ключевые практики безопасности:

  • Белый список IP: Всегда привязывайте ваш ключ API к статическому IP-адресу, с которого вы будете отправлять запросы.
  • Ограничение разрешений: Предоставляйте ключу только минимально необходимые права. Если ключ предназначен только для чтения данных, не давайте ему права на торговлю.
  • Безопасное хранение: Никогда не встраивайте ключи в код. Используйте переменные окружения или специализированные сервисы для управления секретами.
  • Регулярный аудит: Периодически проверяйте активные ключи API, их разрешения и привязанные IP-адреса. Удаляйте ключи, которые больше не используются.

Для чего нужен API? Ключ к автоматизации и ИИ-трейдингу

На первый взгляд, API может показаться инструментом исключительно для разработчиков. Однако его истинная мощь раскрывается в контексте автоматизации и, в частности, ИИ-трейдинга. API — это не просто способ запросить данные; это ворота для ваших программ, ботов и алгоритмов для взаимодействия с биржей напрямую, без человеческого вмешательства.

Именно через API искусственный интеллект может:

  • Собирать данные в реальном времени: ИИ-модели нуждаются в непрерывном потоке актуальных рыночных данных (цены, объемы, книга ордеров) для принятия обоснованных решений. API обеспечивает эту жизненно важную связь.
  • Автоматически исполнять стратегии: После того как ИИ идентифицирует торговую возможность, API позволяет ему мгновенно размещать ордера, модифицировать их или отменять, реагируя на изменения рынка за доли секунды. Эта скорость критически важна для арбитражных стратегий или высокочастотной торговли.
  • Управлять портфелем: ИИ может использовать API для отслеживания ваших активов на бирже, автоматически ребалансировать портфель в соответствии с вашей стратегией или даже управлять рисками, закрывая позиции при достижении определенных условий.

Таким образом, API AsterDEX — это не просто техническая документация, а фундамент, на котором строятся самые передовые и прибыльные стратегии в ИИ-трейдинге. Без него возможности автоматизации были бы крайне ограничены, а потенциал искусственного интеллекта в анализе и исполнении остался бы нереализованным.

Подробно о ИИ-трейдинге

Генерация ключей API

1. Войдите в свою учетную запись AsterDEX и перейдите в раздел "Управление API".

2. Подключите свой кошелек для аутентификации.

3. Нажмите "Создать API" и присвойте вашему ключу понятную метку (например, "read-only-bot").

4. Важно: Система сгенерирует для вас API Key и Secret Key. Секретный ключ будет показан только один раз. Немедленно скопируйте и сохраните его в надежном месте.

Архитектура API

API AsterDEX предлагает два основных интерфейса для взаимодействия:

  • REST API (Pull-модель): Интерфейс "запрос-ответ", идеально подходящий для инициируемых вами действий, таких как размещение ордера, проверка баланса или отмена заявки.
  • WebSocket API (Push-модель): Устанавливает постоянное соединение, позволяя серверу отправлять вам данные в реальном времени. Это необходимо для отслеживания книги ордеров, сделок и других рыночных событий без задержек.

Краткий справочник

  • Базовый URL REST: `https://fapi.asterdex.com`
  • Поток WebSocket: `wss://fstream.asterdex.com/ws`
  • Формат данных: JSON
  • Аутентификация: HMAC SHA256
  • Ограничение скорости: 1200 запросов/минуту

Первые шаги: Подключение и примеры

Проверка соединения (Ping)

Чтобы убедиться, что вы можете подключиться к API, используйте эндпоинт `/fapi/v1/ping`, который не требует аутентификации.

curl -X GET "https://fapi.asterdex.com/fapi/v1/ping"

Успешный ответ вернет пустой JSON-объект: `{}`.

Подписка на данные через WebSocket

Для получения данных в реальном времени, например, агрегированных сделок по паре BTC/USDT, подключитесь к WebSocket и отправьте `SUBSCRIBE` сообщение.

URL: `wss://fstream.asterdex.com/ws`

Пример подписки:

{
  "method": "SUBSCRIBE",
  "params": [
    "btcusdt@aggTrade"
  ],
  "id": 1
}

Обзор ключевых эндпоинтов

Информация о бирже (`/fapi/v1/exchangeinfo`)

Этот эндпоинт — ваша точка входа. Он предоставляет всю необходимую информацию о торговых правилах, парах, фильтрах цен и размеров лотов. Крайне важно запрашивать эти данные перед началом торговли, чтобы понимать ограничения, такие как `tickSize` (минимальное изменение цены) и `stepSize` (минимальный объем ордера).

Данные о рынке

  • /fapi/v1/depth: Глубина книги ордеров. Позволяет увидеть текущие заявки на покупку и продажу.
  • /fapi/v1/klines: Исторические данные (свечи) для анализа ценовых движений.
  • /fapi/v1/historicalTrades: Лента исторических сделок.

Управление счетом и ордерами

  • /fapi/v2/balance: Получить баланс вашего счета.
  • /fapi/v2/positionRisk: Информация о ваших открытых позициях.
  • POST /fapi/v1/order: Размещение нового ордера (LIMIT, MARKET, STOP_LOSS и т.д.).
  • DELETE /fapi/v1/order: Отмена открытого ордера.

Для получения полного списка эндпоинтов и их параметров обратитесь к официальной документации AsterDex API на GitHub.