EdgeX API: Документация, Подписи и Интеграции

Инкубированный Amber Group, EdgeX Exchange использует решение масштабирования Layer-2 на базе StarkWare (StarkEx). Ордера сводятся в оффчейн-движке со скоростью до 200,000 транзакций в секунду и задержкой 10 мс. Криптографические доказательства (ZK-proofs) затем публикуются в Ethereum, обеспечивая безопасность на уровне L1 при околонулевых комиссиях за газ.

Безопасность API: Защита L1 и L2 уровней

Благодаря сверхнизким комиссиям (базовая ~0.012% maker / 0.038% taker) и залогу в USDT, API EdgeX идеально подходит для сложных алгоритмических стратегий:

• Маркетмейкинг (HFT): Поддержание ликвидности в стакане ордеров с использованием WebSockets (движок EdgeX обрабатывает ордера быстрее, чем большинство DeFi-протоколов).
• Арбитраж ставки финансирования: Дельта-нейтральные стратегии между EdgeX и централизованными биржами (Binance, Bybit).
• Охота за ликвидациями: Анализ потоков оракула Stork, используемого на EdgeX для расчета Index и Mark Price, для автоматического входа при каскадных ликвидациях.

→ Ончейн-статистика и метрики EdgeX

На EdgeX процесс инициализации разработчика состоит из 3 шагов:

1. Подключение L1 Wallet: Подключите ваш кошелек (например, MetaMask) в интерфейсе EdgeX Exchange. Выберите сеть (Ethereum или Arbitrum).
2. Генерация L2 Stark Key: Платформа запросит подпись для деривации Stark Key. Этот L2-ключ используется математическим движком ZK-Rollup для валидации того, что ордер был размещен именно вами.
3. Создание API Key: Перейдите в настройки API. Система сгенерирует Account ID (API Key) и Secret Key, необходимые для подписи HTTP-заголовков.

Важно: При выставлении ордера через приватный API, тело заявки подписывается вашим L2 Stark Key (Stark Signature), а сам HTTP-запрос защищается заголовками на основе вашего Secret Key.

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

• REST API (Pull-модель): Размещение и отмена ордеров, запросы баланса и истории сделок.
• WebSocket API (Push-модель): Мгновенные обновления стакана ордеров (15 или 200 уровней глубины), потоки сделок в реальном времени и приватные события аккаунта.

Справочник сред (Environments)

• Mainnet REST (EdgeX): https://pro.edgex.exchange
• Mainnet WebSocket: wss://quote.edgex.exchange
• Аутентификация: Для приватных (Third-party) API вызовов требуется формирование подписей на базе вашего ключа, спецификации которых подробно описаны в документации EdgeX (GitBook).

При написании торговых алгоритмов важно правильно обрабатывать ответы сервера. Основные ошибки движка StarkEx / EdgeX:

Для быстрого старта с инфраструктурой EdgeX ознакомьтесь с нашими материалами:

• Торговый бот на Python для EdgeX — Работа с библиотеками подписи StarkEx и формирование лимитных ордеров.
• Потоковые данные с WebSocket (Node.js) — Получение стакана (orderbook) и агрегированных сделок без задержек.
• Примеры интеграции и создание клиентов API — Сниппеты кода для REST API.

Проверка доступности (Public API)

Для проверки связи запросите список доступных торговых пар (эндпоинт не требует аутентификации):

curl -X GET "https://pro.edgex.exchange/api/v1/symbols"

Node.js: Получение книги ордеров

Пример использования axios для получения стакана ордеров по паре BTC-USDT (в EdgeX залогом является USDT):

const axios = require('axios');

async function getOrderbook() {
  try {
    const response = await axios.get('https://pro.edgex.exchange/api/v1/depth', {
      params: {
        symbol: 'BTC-USDT',
        limit: 5
      }
    });
    console.log("Топ 5 заявок Ask:", response.data.data.asks);
  } catch (error) {
    console.error("Ошибка API:", error.response ? error.response.data : error.message);
  }
}

getOrderbook();

Алгоритмическая торговля через FMZ

Платформа FMZ Quant имеет встроенную, полностью функциональную поддержку EdgeX DEX. Вам не нужно писать логику подписей L2 с нуля. В панели FMZ добавьте новую биржу, выберите EdgeX, введите ваш AccountID (Access Key) и SecretKey.

Это позволяет мгновенно запускать сложные стратегии (например, сеточную торговлю "Grid Trading" или многоуровневый арбитраж по полосам Боллинджера) используя готовые интерфейсы платформы, транслируя ордера прямо в ZK-движок EdgeX.