Как подключить ИИ-агента к криптобирже — гайд по инструментам 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), каждый из которых решает конкретную задачу.
Навыки поддерживают 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).
Пример:
Весь процесс от условия до исполнения проходит без ручного вмешательства.Модуль платежей построен на протоколе x402 и позволяет агентам проводить микроплатежи автономно. При исполнении на X Layer — собственном блокчейне OKX — комиссия за газ равна нулю.
Agent Trade Kit: ИИ-трейдинг на централизованной бирже
Если OnchainOS покрывает ончейн-операции, то Agent Trade Kit решает аналогичную задачу для централизованной биржи OKX. Это MCP-тулкит с открытым исходным кодом, который дает ИИ-агентам доступ к спотовой, фьючерсной и опционной торговле через единый интерфейс.
Установить Agent Trade Kit можно одной командой:
Тулкит доступен в двух форматах: okx-trade-mcp (MCP-сервер для агентских платформ) и okx-trade-cli (CLI, интерфейс командной строки, для скриптов и автоматизации с минимальным расходом токенов). Репозиторий доступен на GitHub.
«Вопрос безопасности API-ключей — первое, что волнует трейдера при подключении ИИ-агента к бирже. В большинстве реализаций ключи передаются непосредственно в контекст модели, что создает риск утечки. Agent Trade Kit решает проблему архитектурно. API-ключи хранятся в локальном конфигурационном файле и читаются только MCP-сервером на машине пользователя. Языковая модель не получает доступа к ключам — она отправляет только торговое намерение», — подчеркивают в OKX.
Второй уровень защиты — система разрешений. При запуске сервер проверяет права 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».
При создании укажите нужные доступы: «Чтение» для аналитики, «Вывод» для снятия средств или «Торговля» для исполнения ордеров.
После этого установите тулкит:
Затем настройте учетные данные через интерактивный мастер:
Мастер запросит API-ключ, секрет и пароль. Данные сохраняются локально в (~/.okx/config.toml) и не передаются в модель.
Подключите MCP-сервер к агентской платформе:
Agent Trade Kit совместим с Claude Code, Cursor, VS Code, OpenClaw и любым MCP-клиентом. Модуль рыночных данных работает без API-ключа.Начните с —demo — это позволит проверить, что агент корректно читает рыночные данные, выставляет ордера и управляет позициями. Только после валидации переключайтесь на реальную торговлю.
OnchainOS Skills (DeFi)
1. Получите API-ключ на OKX Developer Portal.
2. Установите навыки — одна команда для любой среды:
Установщик автоматически определит платформу (Claude Code, Cursor, Codex CLI, OpenCode) и настроит окружение.
Для Claude Code также доступна установка через плагин:
3. Настройте ключи. Создайте файл .env в корне проекта:
Не коммитьте .env в git и не раскрывайте ключи в логах или чатах.
4. Подключите MCP-сервер (опционально). 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 закрывают два разных сегмента рынка. Вместе они образуют единую платформу, в которой ИИ-агент работает с централизованной биржей и децентрализованными протоколами одновременно.
Источник: https://forklog.com/exclusive/kak-podklyuchit-ii-agenta-k-kriptobirzhe-gajd-po-instrumentam-okx