deribit-mcp

Подключите Deribit к вашему ИИ-ассистенту. Поддерживает Claude Code, Codex и любые другие MCP-клиенты — подключение одной командой, чтобы ассистент мог смотреть котировки, видеть аккаунт и управлять ордерами.

claude mcp add deribit -- npx -y deribit-mcp

После установки можно спрашивать: «Как сейчас выглядит опционная цепочка BTC?», «Посмотри подразумеваемую волатильность коллов с экспирацией в марте», «Сколько у меня доступной маржи на аккаунте?»

Два уровня защиты по умолчанию: по умолчанию подключается тестовая сеть, по умолчанию торговля отключена. Чтобы размещать реальные ордера, нужно явно включить оба параметра.

Установка

Claude Code

Только для просмотра котировок — никакой настройки не требуется:

claude mcp add deribit -- npx -y deribit-mcp

Чтобы видеть аккаунт и ордера, добавьте API-учётные данные и переключитесь на основную сеть:

claude mcp add deribit \
  --env DERIBIT_ENV=prod \
  --env DERIBIT_CLIENT_ID=你的_client_id \
  --env DERIBIT_CLIENT_SECRET=你的_client_secret \
  -- npx -y deribit-mcp

Codex

Отредактируйте ~/.codex/config.toml (или .codex/config.toml в проекте):

[mcp_servers.deribit]
command = "npx"
args = ["-y", "deribit-mcp"]

[mcp_servers.deribit.env]
DERIBIT_ENV = "prod"
DERIBIT_CLIENT_ID = "你的_client_id"
DERIBIT_CLIENT_SECRET = "你的_client_secret"

Другие MCP-клиенты

Подойдёт любой клиент, поддерживающий stdio. Команда — npx -y deribit-mcp, конфигурация передаётся через переменные окружения.

Запуск из исходников (необязательно)

Если нужно зафиксировать определённую версию или вы изменили код, можно указывать прямо на исходники — не придётся пересобирать после каждого изменения:

git clone https://github.com/freeeverett/deribit-mcp.git
cd deribit-mcp && npm install

[mcp_servers.deribit]
command = "npx"
args = ["tsx", "/绝对路径/deribit-mcp/src/index.ts"]

Цена — примерно вдвое более медленный запуск (около 160 мс против 77 мс), а также необходимость локально установленных зависимостей. Для повседневного использования рекомендуется всё же npx -y deribit-mcp.

Получение API-учётных данных

Создайте ключ в Настройки аккаунта Deribit → API.

Рекомендуется использовать минимальные права: если вы хотите, чтобы ассистент только анализировал, достаточно trade:read — даже при случайном включении торгового переключателя разместить ордер не получится.

Related MCP server: Crypto Options Desk MCP

Параметры конфигурации

Тестовая сеть изолирована: аккаунт и API-ключи на test.deribit.com полностью несовместимы с основной сетью — нужно регистрироваться отдельно на test.deribit.com. В тестовой сети можно бесплатно получить тестовые монеты — удобно сначала отладить процесс, а затем переходить на основную сеть.

Полный интеграционный тест тестовой сети

В корне проекта создайте игнорируемый git-ом файл .env.test, указав только учётные данные тестовой сети:

DERIBIT_CLIENT_ID=你的测试网_client_id
DERIBIT_CLIENT_SECRET=你的测试网_client_secret

Затем запустите:

npm run test:all

Эта команда нативно читает .env.test и принудительно подключается к тестовой сети (настройки основной сети или пользовательские эндпоинты из файла не используются). Она выполняет все 39 инструментов через реальный stdio MCP-клиент; требуется ключ с правами trade:read_write: создаются, изменяются и отменяются лимитные ордера с уникальным тестовым тегом, выполняются кратковременные рыночные открытия и закрытия позиций, а также создаётся тестовый портфель. При выходе скрипт отменяет ордера по этому тегу как запасной вариант; если очистка не удалась, команда завершится с ошибкой. Существующий npm run smoke по-прежнему остаётся быстрой регрессией публичных интерфейсов без необходимости учётных данных.

О торговых функциях

Инструменты размещения ордеров по умолчанию не открыты — если не указать DERIBIT_ENABLE_TRADING=true, ваш ассистент вообще не увидит эти инструменты и не сможет случайно их задеть.

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

Обязательно знайте:

• Эти операции приводят к реальным сделкам на вашем настоящем аккаунте — деньги настоящие

• Рекомендуется сначала отладить процесс на тестовой сети, и только потом рассматривать основную

• При основной сети + включённой торговле при запуске сервис выводит явное предупреждение, а ассистент получает инструкцию «обязательно подтверждать с пользователем перед выполнением»

• Но конечный барьер — вы сами: при любом запросе на размещение ордера сначала внимательно посмотрите, а потом нажимайте «согласен»

Если вы хотите, чтобы ассистент только анализировал и не трогал ордера, не включайте этот переключатель — котировки и запросы аккаунта полностью работают и без него.

Возможности

Всего 39 инструментов.

Котировки (18, без учётных данных)

Списки контрактов и валют, спецификации контрактов, даты экспирации, опционные цепочки (открытый интерес / подразумеваемая волатильность / цены спроса и предложения), текущие котировки и глубина стакана, греки опционов, исторические свечи, история цены маркировки, текущий и исторический индекс, историческая реализованная волатильность, индекс волатильности DVOL, ставки фондирования бессрочных контрактов, сделки по всему рынку, объёмы биржи, APR доходных токенов, цены расчёта, записи расчётов и ликвидаций, комбинированные контракты, статус платформы, объявления биржи.

Аккаунт и ордера (16, требуются учётные данные)

Капитал и маржа аккаунта, обзор по всем валютам и блокировка аккаунта, детализация позиций, список субаккаунтов, симуляция портфельной маржи, движения средств, записи расчётов и поставок, история депозитов/выводов/переводов, текущие открытые ордера, статус ордера, исторические ордера, история триггерных ордеров, детализация сделок, сделки по конкретному ордеру, оценка маржи для ордера.

Торговля (5, требуются учётные данные и явное включение)

Размещение ордера (лимитный / рыночный / стоп-лосс / тейк-профит / трейлинг-стоп / айсберг / расширенное ценообразование опционов), изменение ордера, отмена ордера, закрытие позиции, создание многоколенного комбинированного контракта.

Полное соответствие инструментов и интерфейсов см. в docs/API-COVERAGE.md.

Как читать номер версии

Номер версии имеет вид 2.20260721.0:

• 2 — старшая версия API Deribit (v2)

• 20260721 — дата официальной документации Deribit, к которой привязана версия (2026-07-21)

• 0 — номер редакции в рамках этой версии документации

То есть по средней части сразу видно, к документации Deribit за какой день привязана эта версия. Когда Deribit обновляет интерфейсы, этот проект обновляет среднюю часть до новой даты.

Частые вопросы

Ассистент говорит, что не находит инструменты Deribit? Проверьте MCP-логи клиента. При запуске сервис выводит в stderr текущее окружение, статус учётных данных и количество зарегистрированных инструментов — сразу видно, не применилась ли конфигурация или проблема в чём-то другом.

Вижу только инструменты котировок, а инструменты аккаунта пропали? Значит, учётные данные не прочитались. Убедитесь, что DERIBIT_CLIENT_ID и DERIBIT_CLIENT_SECRET оба настроены — если указан только один, сервис сразу завершится с ошибкой и сообщит, чего не хватает.

Не вижу инструментов размещения ордеров? Нужно DERIBIT_ENABLE_TRADING=true и настроенные учётные данные. Это намеренное поведение по умолчанию.

Ошибка invalid_credentials? Неверный ключ или секрет, либо указан ключ тестовой сети при подключении к основной (и наоборот). Аккаунты на двух сетях несовместимы.

Ошибка о недостаточных правах? У API-ключа нет прав trade:read_write. Сервис сообщит об ошибке до размещения ордера, а не создаст ложное впечатление, что ордер уже отправлен. Добавьте права ключу в панели Deribit или отключите торговый переключатель.

Изменил конфигурацию, но ничего не изменилось? MCP-сервис запускается при старте клиента — после изменения переменных окружения нужно перезапустить клиент.

Лицензия

MIT