Как подключить ИИ-агента к криптобирже — гайд по инструментам OKX
ИИ-агенты научились анализировать рынки и формировать торговые стратегии, однако исполнять сделки им приходится через человека: трейдер копирует вывод из чат-бота, переключается на платформу и выставляет ордер вручную.
В марте 2025 года криптобиржа OKX выпустила два набора инструментов, которые устраняют этот разрыв — OnchainOS для ончейн-операций и Agent Trade Kit для торговли на централизованной площадке. Разбираемся, как они работают и зачем нужны.
Что такое ИИ-агент и зачем ему доступ к бирже
ИИ-агент — это программа на базе языковой модели, которая выполняет задачи автономно. В отличие от обычного чат-бота, агент не просто отвечает на вопросы — он принимает решения, вызывает внешние сервисы и действует по цепочке шагов без постоянного вмешательства человека.
Агенты умеют отслеживать цены, анализировать ончейн-данные и формировать торговые гипотезы. Но между анализом и исполнением сделки остается ручной этап: трейдер читает рекомендацию, затем переходит в терминал и выставляет ордер самостоятельно.
Чтобы устранить это ограничение, разработчики дают агенту программный доступ к торговой инфраструктуре. Для этого используют протокол MCP (Model Context Protocol) — открытый стандарт, который компания Anthropic представила 25 ноября 2024 года. Он обеспечивает универсальный способ подключения языковых моделей к внешним данным, инструментам и сервисам.
OKX реализовала поддержку MCP в двух продуктах: OnchainOS охватывает децентрализованные рынки, Agent Trade Kit — централизованную биржу. Вместе они образуют единую среду, в которой ИИ-агент оперирует как ончейн-активами, так и биржевыми инструментами.
OnchainOS: ИИ для ончейн-операций
OnchainOS — набор инструментов для разработчиков, который открывает ИИ-агентам доступ к Web3-кошельку OKX и ончейн-маркетплейсу. По данным OKX, кошельком пользуются более 12 млн человек ежемесячно.
Платформа поддерживает более 60 блокчейнов, агрегирует ликвидность с децентрализованных бирж и обрабатывает свыше 1,2 млрд API-запросов в сутки. Среднее время отклика — менее 100 мс, заявленный аптайм — 99,9%.
В зависимости от задачи и уровня контроля OnchainOS предлагает разработчикам три интерфейса:
- AI Skills — самый простой вариант. Агент описывает действие на естественном языке, а OnchainOS интерпретирует запрос и выполняет операцию. Разработчику не нужно разбираться в специфике конкретного блокчейна или писать код интеграции;
- MCP-сервер — подключение к агентским платформам. Через MCP OnchainOS интегрируется с Claude Code, Cursor, OpenClaw и другими средами. Система вызывает ончейн-функции как обычные инструменты внутри рабочей сессии;
- Open API — прямой RESTful-доступ ко всем возможностям платформы. Подходит для разработчиков, которым нужен полный контроль над логикой приложения.
Исходный код OnchainOS Skills опубликован на GitHub. Набор включает семь специализированных навыков (skills), каждый из которых решает конкретную задачу.
| Skill | Функции |
|---|---|
| okx-wallet-portfolio | Показывает баланс кошелька, перечисляет токены и рассчитывает стоимость портфеля |
| okx-dex-market | Отображает цены в реальном времени, графики, индексные цены, прибыль и убыток кошелька |
| okx-dex-signal | Отслеживает сигналы smart money, китов и лидеров мнений |
| okx-dex-trenches | Сканирует мем-токены и репутацию разработчиков |
| okx-dex-swap | Обменивает токены через агрегатор с доступом к более чем 500 источникам ликвидности |
| okx-dex-token | Ищет токены, возвращает метаданные, капитализацию, рейтинги, пулы ликвидности, данные о холдерах и историю торгов |
| okx-onchain-gateway | Оценивает газ, симулирует транзакции, отправляет их в блокчейн и отслеживает статус подтверждения |
Навыки поддерживают X Layer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon и еще более 20 сетей.
Как работают Skills
Навыки спроектированы как звенья одной цепочки — агент комбинирует их в зависимости от задачи. Несколько типичных сценариев:
- поиск и покупка токена. Агент находит токен (okx-dex-token), проверяет баланс (okx-wallet-portfolio) и исполняет сделку (okx-dex-swap);
- обзор портфеля. Система запрашивает активы (okx-wallet-portfolio), обогащает данные аналитикой (okx-dex-token) и строит графики (okx-dex-market);
- полный торговый цикл. Агент ищет токен (okx-dex-token), анализирует график (okx-dex-market), проверяет баланс (okx-wallet-portfolio), получает данные транзакции (okx-dex-swap), симулирует, отправляет и отслеживает исполнение (okx-onchain-gateway).
Пример:
- Трейдер пишет: «Обменяй мои ETH на USDC, если цена ETH упадет ниже $2000».
- Агент отслеживает цену в реальном времени через okx-dex-market.
- При срабатывании условия — проверяет безопасность токена и ликвидность через okx-dex-token.
- Находит лучший маршрут обмена через okx-dex-swap.
- Симулирует транзакцию и отправляет ее через okx-onchain-gateway.
- Отслеживает подтверждение в блокчейне.
- Сообщает результат: «Получено 1337 USDC».
Весь процесс от условия до исполнения проходит без ручного вмешательства.Модуль платежей построен на протоколе x402 и позволяет агентам проводить микроплатежи автономно. При исполнении на X Layer — собственном блокчейне OKX — комиссия за газ равна нулю.
Agent Trade Kit: ИИ-трейдинг на централизованной бирже
Если OnchainOS покрывает ончейн-операции, то Agent Trade Kit решает аналогичную задачу для централизованной биржи OKX. Это MCP-тулкит с открытым исходным кодом, который дает ИИ-агентам доступ к спотовой, фьючерсной и опционной торговле через единый интерфейс.
Установить Agent Trade Kit можно одной командой:
npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli
Тулкит доступен в двух форматах: okx-trade-mcp (MCP-сервер для агентских платформ) и okx-trade-cli (CLI, интерфейс командной строки, для скриптов и автоматизации с минимальным расходом токенов). Репозиторий доступен на GitHub.
Второй уровень защиты — система разрешений. При запуске сервер проверяет права API-ключа. Если он не имеет торговых разрешений, инструменты для выставления ордеров не регистрируются в тулбоксе агента. Модель не может даже попытаться выполнить действие, на которое у нее нет прав.
Agent Trade Kit включает 82 инструмента, распределенных по семи модулям:
- спот, бессрочные контракты и фьючерсы. Агент исполняет сделки на всех рынках биржи — от простых спотовых покупок до позиций на бессрочных свопах;
- опционы. OKX позиционирует Agent Trade Kit как единственный биржевой MCP-тулкит с поддержкой опционной торговли. Инструмент предоставляет доступ к рыночным данным, стаканам, открытому интересу и управлению позициями — для трейдеров, которые хеджируют экспозицию или строят многоуровневые стратегии;
- алгоритмические ордера. Агент выставляет OCO-ордера, трейлинг-стопы и условные триггеры. Команды формулируются на естественном языке — система интерпретирует намерение и транслирует его в параметры ордера;
- торговые боты. Через Agent Trade Kit можно настроить гридовые и DCA-боты в диалоговом режиме;
- управление аккаунтом. Система запрашивает балансы, открытые позиции и историю торгов внутри рабочей сессии;
- демо-режим. Полный доступ к биржевой среде OKX с симулированными активами. Разработчик тестирует стратегии, валидирует логику исполнения и отлаживает агента без риска реальных потерь.
Для разработчиков, которым нужна конкретная функция, а не полный набор из 82 инструментов, Agent Trade Kit предлагает четыре модуля Skills:
- okx-cex-market — рыночные данные (котировки, стаканы, тикеры);
- okx-cex-trade — торговля (ордера, позиции, исполнение);
- okx-cex-portfolio — портфель (балансы, история, P&L — прибыль и убытки);
- okx-cex-bot — боты (конфигурация грид- и DCA-стратегий).
Модули подключаются отдельно: загружается только нужная функциональность, что экономит контекстное окно.
Как начать: пошаговая инструкция
Agent Trade Kit (CEX)
Создайте API-ключ на OKX. Откройте сайт OKX, затем в верхнем меню выберите «Решения для корпораций», раздел API и «Создать ключ API».
Источник: OKX.
При создании укажите нужные доступы: «Чтение» для аналитики, «Вывод» для снятия средств или «Торговля» для исполнения ордеров.
После этого установите тулкит:
npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli
Затем настройте учетные данные через интерактивный мастер:
okx config init
Мастер запросит API-ключ, секрет и пароль. Данные сохраняются локально в (~/.okx/config.toml) и не передаются в модель.
Подключите MCP-сервер к агентской платформе:
okx-trade-mcp setup --client claude-code okx-trade-mcp setup --client cursor okx-trade-mcp setup --client claude-desktop
Agent Trade Kit совместим с Claude Code, Cursor, VS Code, OpenClaw и любым MCP-клиентом. Модуль рыночных данных работает без API-ключа.Начните с —demo — это позволит проверить, что агент корректно читает рыночные данные, выставляет ордера и управляет позициями. Только после валидации переключайтесь на реальную торговлю.
OnchainOS Skills (DeFi)
1. Получите API-ключ на OKX Developer Portal.
2. Установите навыки — одна команда для любой среды:
npx skills add okx/onchainos-skills
Установщик автоматически определит платформу (Claude Code, Cursor, Codex CLI, OpenCode) и настроит окружение.
Для Claude Code также доступна установка через плагин:
/plugin marketplace add okx/onchainos-skills /plugin install onchainos-skills
3. Настройте ключи. Создайте файл .env в корне проекта:
OKX_API_KEY="your-api-key" OKX_SECRET_KEY="your-secret-key" OKX_PASSPHRASE="your-passphrase"
Не коммитьте .env в git и не раскрывайте ключи в логах или чатах.
4. Подключите MCP-сервер (опционально). CLI OnchainOS работает как нативный MCP-сервер:
claude mcp add --scope user onchainos-cli onchainos mcp
Документация с пошаговыми инструкциями доступна на странице Run Your First AI Agent.
На что обратить внимание
ИИ-агент — не замена трейдеру. Языковые модели могут неправильно интерпретировать рыночную ситуацию или сформулировать некорректный ордер. Команда OKX дает следующие рекомендации для безопасной работы:
- начинайте с демо-режима. Agent Trade Kit предоставляет полноценную тестовую среду с симулированными активами. Используйте ее для отладки логики до перехода на реальные средства;
- ограничивайте разрешения API-ключа. Если агенту нужна только аналитика, не давайте ключу торговых прав. Agent Trade Kit автоматически скроет от модели недоступные функции;
- контролируйте размеры позиций. Задавайте лимиты на максимальный объем одной сделки. Это снижает риск крупных потерь при некорректном поведении агента;
- мониторьте действия агента. Отслеживайте историю ордеров и позиций — как через интерфейс OKX, так и через инструменты управления аккаунтом в Agent Trade Kit;
- обновляйте тулкит. Оба продукта развиваются в открытом доступе. Следите за обновлениями на GitHub: Agent Trade Kit, OnchainOS Skills.
По отдельности OnchainOS и Agent Trade Kit закрывают два разных сегмента рынка. Вместе они образуют единую платформу, в которой ИИ-агент работает с централизованной биржей и децентрализованными протоколами одновременно.
Рассылки ForkLog: держите руку на пульсе биткоин-индустрии!
