Добавить сервер
hypurrquant/perp-cli
  1. Каталог MCP
  2. hypurrquant/perp-cli

hypurrquant/perp-cli

от hypurrquant
perp-cli — мульти-DEX CLI для perpetual futures на Solana, HyperEVM, Ethereum и BNB Chain. Поддерживает арбитраж funding rate, управление портфелем, ботов (TWAP, grid, DCA). Встроенный MCP сервер д...
GithubNPMСайт сервера

perp-cli

npm version npm downloads license

Multi-DEX perpetual futures CLI — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), Aster (BNB Chain), Lighter RH (Robinhood chain), Ondo Perps (off-chain), Arcus (Robinhood chain), QFEX (off-chain, TradFi perps), RISEx (RISE chain — read-only in 0.15.0, trading in a later release), TxFlow (market data only — unofficial API), and Derive options data (read-only).

npm install -g perp-cli       # global install
perp --json portfolio

# Or without global install (restricted environments)
npx -y perp-cli --json portfolio

Features

  • 10 perp venues — trade on 8: Pacifica, Hyperliquid, Lighter, Aster, Lighter RH, Ondo Perps, Arcus, QFEX (bridge / perp-perp arb cover the original four); market data on RISEx (read-only in 0.15.0, trading in a later release) and TxFlow (unofficial API, read-only); plus Derive options data (read-only). See the support matrix
  • Funding Rate Arb — perp-perp + spot-perp scan & one-command dual-leg execution
  • Portfolio — single call returns balances, positions, risk level across all exchanges
  • Funds — deposit, withdraw, transfer, multi-provider bridge (cctp/relay/debridge), inter-exchange rebalance — all in one group
  • Bots — TWAP, grid, DCA, trailing-stop with background job management
  • Agent-First Design — --json, --fields, --ndjson, --dry-run, runtime schema introspection
  • Safety — pre-trade validation, response sanitization, client-id deduplication

Часто задаваемые вопросы

Инструменты были проиндексированы:
arb_scan

Сканирует возможности арбитража ставок финансирования между биржами. Находит символы с наибольшим спредом ставок финансирования.

Параметры
  • minSpreadnumber

    Минимальный годовой спред % для отображения (по умолчанию: 5)

  • symbolsstring[]

    Отфильтруйте по конкретным символам. Оставьте пустым для всех.

explain_command

Объясняет, что делает команда perp CLI, её параметры и возможные риски. Помогает пользователю понять команду перед её запуском.

Параметры
  • commandstringобязательный

    Объясняет команду CLI, например, "perp trade market BTC buy 0.1" или "perp arb scan".

get_arb_compare

Сравнивает активные арбитражные позиции рядом: ROI, funding income, price PnL и annualized returns для каждой позиции.

Параметры
  • periodstring

    Период поиска финансирования: 7 дней, 30 дней, 90 дней или всё время.

get_balance

Получает баланс аккаунта на бирже (equity, available margin, margin used, unrealized PnL). Hyperliquid: только нативные перпы (HIP-3 dexes через CLI --dex).

Параметры
  • exchangestringобязательный

    Название биржи: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются алиасы)

get_funding_analysis

Анализирует доход от финансирования по биржам: совокупные суммы, годовые ставки и разбивку по каждой арбитражной позиции. Отлично подходит для отслеживания прибыльности арбитража на финансировании.

Параметры
  • exchangestring

    Фильтровать по бирже

  • periodstring

    Период времени: 7д, 30д, 90д или все

  • symbolstring

    Фильтр по символу

get_funding_rates

Сравнивает ставки финансирования по всем площадкам рыночных данных. Возвращает ставки по каждому символу с анализом спреда.

Параметры
  • minSpreadnumber

    Минимальный годовой спред для включения (по умолчанию: 0)

  • symbolsstring[]

    Фильтровать по конкретным символам (например, ['BTC','ETH']). Если не указано, вернутся все доступные.

get_markets

Получает все доступные рынки бессрочных фьючерсов на бирже, включая цену, ставку финансирования, объём и максимальное кредитное плечо. Работает без API-ключей (публичные рыночные данные). Hyperliquid: только нативные бессрочные контракты (HIP-3 dexes через CLI --dex).

Параметры
  • exchangestringобязательный

    Название биржи: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются алиасы)

get_open_orders

Получает все открытые/ожидающие ордера на бирже. Hyperliquid: только нативные перпы (HIP-3 dex через CLI --dex).

Параметры
  • exchangestringобязательный

    Название биржи: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются алиасы)

get_orderbook

Получает книгу заявок (биды и аски) для символа на бирже. Работает без API-ключей на каждой площадке с API аккаунта (настроенные учётные данные → адаптер аккаунта; если их нет → публичный endpoint / адаптер только для чтения); у площадок только с рыночными данными пути к книге заявок нет. Hyperliquid: только нативные перпы (HIP-3 dexes через CLI --dex).

Параметры
  • exchangestringобязательный

    Название биржи: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются алиасы)

  • symbolstringобязательный

    Символ торговой пары, например, BTC, ETH, SOL

get_outcome_book

Получает стакан заявок для одной стороны исхода. Публичное чтение, API-ключ не нужен.

Параметры
  • outcomeintegerобязательный

    Outcome id из outcomeMeta (например, 1 для BTC binary daily)

  • sideintegerобязательный

    Индекс стороны внутри outcome (0 = первая запись sideSpecs, например 'Yes', 1 = вторая, например 'No')

get_outcome_markets

Перечисляет активные рынки Hyperliquid Outcome (HIP-4). У каждого рынка есть разобранные метаданные (базовый актив, целевая цена, срок истечения, период) и информация по каждой стороне (название Yes/No, кодировка, id актива, текущая средняя цена). Публичное чтение - API-ключ не нужен.

Параметры

Без параметров.

get_outcome_positions

Получает открытые outcome-позиции активного аккаунта (size, entry notional, mark price, unrealized PnL). Требует настроенный кошелёк Hyperliquid или агент.

Параметры

Без параметров.

get_outcome_view

Возвращает сводное представление по одному рынку исхода: стаканы всех сторон параллельно + разрыв mark price базового актива (относительно targetPrice) + время до экспирации + подразумеваемая вероятность по каждой стороне (сумма mid). Для бинарных рынков симметричная структура означает Yes bid + No ask ≈ 1.0 - представление показывает обе стороны за один round-trip и выводит направленный контекст (например, BTC сейчас выше target). Публичное чтение.

Параметры
  • depthinteger

    Количество уровней книги заявок на сторону

  • outcomeintegerобязательный

    Outcome id из outcomeMeta (например, 1 для BTC binary daily)

get_pnl_analysis

Анализ P&L, объединяющий торговые комиссии и доход от финансирования: показывает чистую прибыль/убыток по биржам с разбивкой по дням.

Параметры
  • exchangestring

    Фильтровать по бирже

  • periodstring

    Период времени: 7д, 30д, 90д или все

get_positions

Получает все открытые позиции на бирже, включая размер, цену входа, PnL, плечо. Hyperliquid: только нативные перпы (дексы HIP-3 через CLI --dex).

Параметры
  • exchangestringобязательный

    Название биржи: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются алиасы)

get_prices

Получает кросс-биржевые цены по символам. Запрашивает mark-цены со всех площадок рыночных данных для сравнения.

Параметры
  • symbolsstring[]

    Символы для получения цен (например, ['BTC','ETH']). Не указывайте для топовых активов.

health_check

Пингует все зарегистрированные площадки в сети сервера и возвращает статус подключения и задержку. Pacifica / Hyperliquid / Lighter / Aster / QFEX: REST ping (status = HTTP status, 0 = нет ответа); все остальные площадки: чтение их публичных рыночных данных (status null). Сбой сопровождается сообщением об ошибке.

Параметры

Без параметров.

portfolio

Сводка кросс-биржевого портфеля: балансы, позиции и метрики риска по всем биржам с настроенными учётными данными

Параметры

Без параметров.

suggest_command

По заданной цели торговли на естественном языке предложите точные команды CLI perp для выполнения. НЕ выполняет ничего - только возвращает команды для просмотра и ручного запуска пользователем.

Параметры
  • exchangestring

    Предпочитаемая биржа (по умолчанию: settings.defaultExchange, иначе pacifica, значение по умолчанию для -e в CLI). Варианты: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex

  • goalstringобязательный

    Естественно-языковая цель, например: «купить 0,1 BTC на pacifica», «закрыть все позиции», «проверить возможности арбитража по ставкам финансирования»

trade_close

Закрывает существующую позицию. ВАЖНО: сначала вызовите trade_preview с противоположной стороной, чтобы показать влияние, затем получите подтверждение пользователя. Подтверждённое закрытие: closedSize - это измеренное / окончательное на площадке исполнение (предпринимается одна попытка закрыть остаток по рынку); остаток всё ещё открыт → ошибка ORDER_PARTIAL (символ помещён в карантин). Включает унифицированный OrderResult рыночного ордера reduce-only. Hyperliquid: только нативные перпы (HIP-3 DEX через CLI --dex).

Параметры
  • exchangestringобязательный

    Биржа: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются псевдонимы)

  • symbolstringобязательный

    Символ для закрытия (например, BTC, ETH)

trade_execute

Выполняет РЕАЛЬНУЮ сделку в сети сервера (meta.network; PERP_NETWORK, по умолчанию mainnet). ВАЖНО: сначала всегда требуется вызвать trade_preview и получить явное подтверждение пользователя перед вызовом этого инструмента. Отклоняется с RISK_VIOLATION, когда ордер нарушает локальные лимиты риска (набор рисков по перпам; переопределение через MCP отсутствует) или когда символ помещён в карантин (проходят только reduce-only ордера). Каждый ордер записывается в журнал исполнения. Поддерживает рыночные и лимитные ордера. Возвращает унифицированный OrderResult (status, finality, filledSize, execution: slippage / protection price / TIF sent) с сырым ответом площадки в поле legacy, а также filledSize / requestedSize / partial на верхнем уровне. Исходы: неизвестный исход (сбой транспорта после отправки или нефинальное подтверждение площадки) → ok:false, code ORDER_PENDING, executed:false, pending:true и рекомендация "do NOT resubmit": символ помещается в карантин для открывающих ордеров, пока человек его не снимет; финальный отказ / отмена без исполнения → ORDER_REJECTED, executed:false; отмена после частичного исполнения → executed:true, partial:true с реальным filledSize. Hyperliquid: только нативные перпы (HIP-3 dexes через CLI --dex).

Параметры
  • exchangestringобязательный

    Биржа: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются псевдонимы)

  • orderTypeenum

    Тип заказа.

  • pricestring

    Лимитная цена (обязательно для лимитных ордеров)

  • reduceOnlyboolean

    Ордер только на уменьшение (только закрытие позиции)

  • sideenumобязательный

    Сторона ордера

  • sizestringобязательный

    Размер ордера (в единицах базовой валюты)

  • slippageBpsnumber

    Рыночные ордера: предел проскальзывания в bps (по умолчанию: settings defaultSlippageBps)

  • symbolstringобязательный

    Торговый символ (например, BTC, ETH, SOL)

  • tifstring

    Лимитные ордера: GTC (по умолчанию) | IOC | FOK | ALO (post-only); принимаются алиасы площадок GTT / GTX / TOB

trade_preview

Показывает сделку БЕЗ исполнения. Запускает проверки trade_execute перед отправкой в режиме только чтения (разбор размера, валидация ордера, включая TIF, карантин, локальные лимиты риска, которые никогда не применяются принудительно) и сообщает о любом отказе как valid:false с его кодом + способом устранения; также возвращает оценочную цену исполнения из книги, номинал, влияние на маржу, комиссию builder, которую понесёт ордер, и текущую позицию. Торговые комиссии площадки НЕ оцениваются. ВСЕГДА вызывайте этот инструмент перед trade_execute и показывайте результат пользователю для подтверждения. Hyperliquid: только нативные перпы (HIP-3 dexes через CLI --dex).

Параметры
  • exchangestringобязательный

    Биржа: pacifica, hyperliquid, lighter, aster, lighter-rh, ondo, arcus, qfex (принимаются псевдонимы)

  • orderTypeenum

    Тип заказа.

  • pricestring

    Лимитная цена (обязательно для лимитных ордеров)

  • reduceOnlyboolean

    Ордер reduce-only (только закрытие позиции) - проверяется так же, как trade_execute (карантин применяется только к ордерам, не reduce-only)

  • sideenumобязательный

    Сторона ордера

  • sizestringобязательный

    Размер ордера (единицы базовой валюты, например, '0.1' для 0.1 BTC)

  • symbolstringобязательный

    Торговый символ (например, BTC, ETH, SOL)

  • tifstring

    Лимитные ордера: GTC (по умолчанию) | IOC | FOK | ALO (post-only); псевдонимы площадок GTT / GTX / TOB принимаются - проверяются так же, как trade_execute

0.15.0основная
0.14.3
0.14.2
0.14.1
0.14.0
0.12.17
0.12.15
0.12.14
0.12.13
0.12.12
0.12.11
0.12.10
0.12.9
0.12.8
0.12.6
0.12.5
0.12.3
0.12.2
0.12.1
0.12.0
0.11.0
0.9.8
0.9.7
0.9.6
0.9.4
0.9.3
0.9.2
0.9.1
0.7.50
0.7.48
0.7.47
0.7.43
0.7.42
0.7.39
0.7.37
0.7.36
0.7.32
0.7.30
0.7.24
0.7.23
0.7.21
0.7.20
0.7.19
0.7.17
0.7.16
0.7.15
0.7.13
0.7.12
0.7.11
0.7.10
0.7.9
0.7.8
0.7.7
0.7.6
0.7.5
0.7.4
0.7.3
0.7.2
0.7.1
0.6.4
0.6.3
0.6.2
0.6.1
0.6.0
0.5.3
0.5.2
0.5.0
0.4.12
0.4.11
0.4.10
0.4.9
0.4.8
0.4.2
0.4.0
0.3.19
0.3.18
0.3.17
0.3.16
0.3.15
0.3.14
0.3.13
0.3.12
0.3.11
0.3.10
0.3.9
0.3.8
0.3.7
0.3.6
0.3.5
0.3.4
0.3.3

Выберите клиент, чтобы установить hypurrquant/perp-cli:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"hypurrquant-perp-cli-47e88tbsgf\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"-p\",\"perp-cli\",\"perp-mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add hypurrquant-perp-cli-47e88tbsgf -- npx -y -p perp-cli perp-mcp

Либо через JSON-конфиг:

claude mcp add-json hypurrquant-perp-cli-47e88tbsgf "{\"command\":\"npx\",\"args\":[\"-y\",\"-p\",\"perp-cli\",\"perp-mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add hypurrquant-perp-cli-47e88tbsgf -- npx -y -p perp-cli perp-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.hypurrquant-perp-cli-47e88tbsgf]
command = "npx"
args = ["-y", "-p", "perp-cli", "perp-mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите hypurrquant/perp-cli, а в поле команды запуска — строку ниже:
npx -y -p perp-cli perp-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например hypurrquant-perp-cli-47e88tbsgf.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: hypurrquant-perp-cli-47e88tbsgf
    command: npx
    args:
      - "-y"
      - "-p"
      - "perp-cli"
      - "perp-mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "hypurrquant-perp-cli-47e88tbsgf": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "perp-cli",
        "perp-mcp"
      ]
    }
  }
}

Похожие MCP-сервера

TradeRouter/trade-router-mcp

TradeRouter/trade-router-mcp

от traderouter

MCP-сервер для некастодиальной торговли на Solana: свопы, лимитные, трейлинговые, DCA, TWAP и комбо-ордера через TradeRouter.ai. Позволяет AI-агентам безопасно подписывать транзакции локально, без ...

JavaScript⭐ 3
armorwallet/armor-crypto-mcp

armorwallet/armor-crypto-mcp

от armorwallet

MCP сервер Armor Crypto связывает AI-агентов с криптоэкосистемой: управление кошельками, свопы и кастомные ордера (DCA, стоп-лосс) со встроенным стейкингом. Сейчас Solana, в будущем десятки блокчейнов. Идеально для автоматизации.

Python⭐ 178
namixai/funding-mcp

namixai/funding-mcp

от namixai

Мультивендорный MCP-сервер для perpetual и HIP-3 данных: funding rates, OI, ликвидность и RWA с 20+ бирж (Binance, Bybit, Hyperliquid, HIP-3 суб-DEX). Платные инструменты — USDC через x402, бесплат...

JavaScript⭐ 2
kukapay/funding-rates-mcp

kukapay/funding-rates-mcp

от kukapay

MCP-сервер для мониторинга реальных funding rates на Binance, OKX, Bybit, Bitget, Gate, CoinEx. Выводит таблицу с колонкой Divergence, помогая трейдерам и AI-агентам находить арбитражные возможност...

Python⭐ 8
intentos-labs/beeper-mcp

intentos-labs/beeper-mcp

от intentos-labs

MCP-сервер для выполнения транзакций beeper в Binance Smart Chain. Проверяйте балансы, переводите BNB и токены, меняйте их через PancakeSwap, покупайте/продавайте токены и забирайте награды. Полезен для автоматизации DeFi-операций.

Python⭐ 3
araa47/jupiter-mcp

araa47/jupiter-mcp

от araa47

Сервер MCP для Jupiter API - агрегатора DEX на Solana. Поддерживает мгновенные свопы через Ultra API и лимитные ордера через Trigger API. Интегрируется с AI-ассистентами для автоматизации DeFi-опер...

Python⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин