dYdX Chain API: Документация, SDK и Интеграции

В отличие от версии v3, dYdX Chain (v4) является полностью независимым блокчейном уровня 1, построенным на Cosmos SDK. Здесь нет централизованного сервера сведения ордеров: книга ордеров хранится в оперативной памяти сети валидаторов. Это означает кардинальную смену парадигмы для разработчиков.

→ Подробнее об архитектуре dYdX Chain

Два слоя взаимодействия:

• Indexer API (Чтение): Специализированные сервера, которые индексируют блокчейн и предоставляют REST и WebSocket API (свечи, стаканы, история сделок) для быстрой работы без нагрузки на RPC ноды.
• RPC/gRPC (Запись): Ордера (размещение, отмена) — это транзакции в блокчейне. Вы должны подписать их локально и отправить валидаторам (без газа).

Благодаря нулевым комиссиям за газ на выставление и отмену ордеров, dYdX Chain идеально подходит для сложных алгоритмических стратегий:

• Арбитраж ставки финансирования (Funding Rate Arbitrage): Дельта-нейтральные стратегии между dYdX и CEX (например, Binance) с использованием котировок USD.
• Высокочастотный маркетмейкинг (HFT): In-memory книга ордеров валидаторов позволяет выставлять и отменять десятки заявок в секунду.
• Охота за ликвидациями: Анализ Indexer Price для перехвата рыночных дисбалансов при принудительном закрытии позиций.

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

На dYdX v4 процесс инициализации разработчика сильно отличается от классических бирж:

1. Деривация субаккаунта: Вы подключаете свой Ethereum-кошелек к dYdX, который посредством криптографической подписи генерирует dydx... адрес (Cosmos-формат) и мнемоническую фразу субаккаунта.
2. Экспорт ключей: Из интерфейса биржи (раздел "Export Secret Phrase" для API) вы получаете секретную фразу.
3. Инициализация SDK: В вашем коде вы используете официальные библиотеки (@dydxprotocol/v4-client-js или v4-web-python-client), передаете им мнемонику, и SDK берет на себя всю сложную работу по формированию Cosmos-транзакций (MsgPlaceOrder).

Важно: Ваш бот должен формировать и подписывать каждую заявку (транзакцию) локально перед отправкой на ноду валидатора.

dYdX предоставляет публичный кластер Индексаторов для получения данных:

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

• Mainnet Indexer REST: https://indexer.dydx.trade
• Mainnet Indexer WebSocket: wss://indexer.dydx.trade/v4/ws
• Testnet: https://indexer.v4testnet.dydx.exchange — используйте для тестирования стратегий.
• Официальные SDK: Рекомендуется использовать официальные клиенты для TypeScript и Python, так как они автоматически парсят Protobuf-сообщения и обрабатывают RPC запросы.

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

Для быстрого старта с dYdX Chain мы рекомендуем использовать официальные SDK:

• Торговый бот на Python (v4-client) — Инициализация кошелька, подпись MsgPlaceOrder и отправка через gRPC.
• Потоковые данные WebSocket (TypeScript) — Получение Orderbook L2 и агрегированных сделок через Indexer.
• Примеры интеграции — Сниппеты кода для управления кросс-маржой субаккаунта.

Получение списка рынков (REST)

Для публичных данных аутентификация не требуется. Получите активные торговые пары (например, `BTC-USD`):

curl -X GET "https://indexer.dydx.trade/v4/markets"

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

Для получения рыночных данных в реальном времени:

URL: `wss://indexer.dydx.trade/v4/ws`

{
  "type": "subscribe",
  "channel": "v4_markets"
}

Node.js: Базовый запрос к Indexer API

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

const axios = require('axios');

async function getOrderbook() {
  try {
    const response = await axios.get('https://indexer.dydx.trade/v4/orderbooks/perpetualMarket/BTC-USD');
    console.log("Топ заявки Ask:", response.data.asks.slice(0, 5));
  } catch (error) {
    console.error("Ошибка API:", error.response ? error.response.data : error.message);
  }
}

getOrderbook();

Публичные данные рынка

• GET /v4/markets: Статус рынков, индексы цен, шаг цены (tick size) и объем лота.
• GET /v4/orderbooks/perpetualMarket/{ticker}: Глубина книги ордеров.
• GET /v4/candles/perpetualMarket/{ticker}: Исторические данные свечей.

Данные Аккаунта (Требуется адрес субаккаунта)

• GET /v4/addresses/{address}/subaccounts/{subaccountNumber}: Получение баланса, свободной маржи и открытых позиций конкретного субаккаунта.

Напоминание: Для отправки ордеров и управления счетом (Запись) необходимо использовать SDK для трансляции Cosmos транзакций (Tx) к валидаторам, а не Indexer API.

Маркетмейкинг через Hummingbot

Для алготрейдеров, желающих запустить маркетмейкинг без написания низкоуровневого кода, Hummingbot имеет полностью рабочий коннектор для dYdX v4 (dYdX Chain). Вы можете настроить бота для Pure Market Making или Cross-Exchange Arbitrage. Коннектор Hummingbot уже "под капотом" работает с Cosmos-транзакциями, вам нужно лишь скормить ему вашу мнемоническую фразу (Secret Mnemonic) от субаккаунта через защищенный интерфейс.