Каталог MCP
hypurrquant/perp-cli

hypurrquant/perp-cli

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

README

18 инструментов

Версии

Установить сервер

perp-cli

Multi-DEX perpetual futures CLI — Pacifica (Solana), Hyperliquid (HyperEVM), Lighter (Ethereum), Aster (BNB Chain).

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

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

Features

4 Exchanges — trade, bridge, arbitrage across Pacifica, Hyperliquid, Lighter, Aster
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

Setup

# Set exchange keys
perp wallet set pac <SOLANA_KEY>     # Pacifica
perp wallet set hl <EVM_KEY>         # Hyperliquid
perp wallet set lt <EVM_KEY>         # Lighter (API key auto-generated)
perp wallet set aster <API_KEY>      # Aster (BNB Chain)

# Or interactive setup wizard
perp setup

# Verify
perp wallet show

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

arb_scan

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

Параметры

minSpreadnumber
Minimum annualized spread % to show (default: 5)
symbolsstring[]
Filter to specific symbols. Omit for all

explain_command

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

Параметры

commandstringобязательный
The CLI command to explain, e.g. 'perp trade market BTC buy 0.1' or 'perp arb scan'

get_arb_compare

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

Параметры

periodstring
Funding lookup period: 7d, 30d, 90d, or all

get_balance

Получить баланс аккаунта (средства, доступная маржа, использованная маржа, нереализованная PnL) на бирже

Параметры

exchangestringобязательный
Exchange name: pacifica, hyperliquid, lighter, or aster

get_funding_analysis

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

Параметры

exchangestring
Filter by exchange
periodstring
Time period: 7d, 30d, 90d, or all
symbolstring
Filter by symbol

get_funding_rates

Сравнивает ставки финансирования на всех 4 биржах (Pacifica, Hyperliquid, Lighter, Aster). Возвращает ставки по каждому символу с анализом спреда.

Параметры

minSpreadnumber
Minimum annualized spread % to include (default: 0)
symbolsstring[]
Filter to specific symbols (e.g. ['BTC','ETH']). Omit for all available

get_markets

Получить все доступные рынки бессрочных фьючерсов на бирже, включая цену, ставку финансирования, объём и максимальное кредитное плечо. Работает без API-ключей.

Параметры

exchangestringобязательный
Exchange name: pacifica, hyperliquid, lighter, or aster

get_open_orders

Получить все открытые/ожидающие ордера на бирже

Параметры

exchangestringобязательный
Exchange name: pacifica, hyperliquid, lighter, or aster

get_orderbook

Получить книгу заказов (заявки на покупку и продажу) для символа на бирже. Работает без API-ключей.

Параметры

exchangestringобязательный
Exchange name: pacifica, hyperliquid, lighter, or aster
symbolstringобязательный
Trading pair symbol, e.g. BTC, ETH, SOL

get_pnl_analysis

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

Параметры

exchangestring
Filter by exchange
periodstring
Time period: 7d, 30d, 90d, or all

get_positions

Получить все открытые позиции на бирже, включая размер, цену входа, PnL, leverage.

Параметры

exchangestringобязательный
Exchange name: pacifica, hyperliquid, lighter, or aster

get_prices

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

Параметры

symbolsstring[]
Symbols to fetch prices for (e.g. ['BTC','ETH']). Omit for top assets

health_check

Пингует все 4 биржи и возвращает статус соединения и задержку.

Параметры

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

portfolio

Межбиржевой обзор портфеля: балансы, позиции и метрики риска по всем 4 биржам

Параметры

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

suggest_command

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

Параметры

exchangestring
Preferred exchange (default: pacifica). Options: pacifica, hyperliquid, lighter, aster
goalstringобязательный
Natural language goal, e.g. 'buy 0.1 BTC on pacifica', 'close all positions', 'check funding arb opportunities'

trade_close

Закрыть существующую позицию. ВАЖНО: сначала вызовите trade_preview с противоположной стороной, чтобы показать влияние, затем получите подтверждение пользователя.

Параметры

exchangestringобязательный
Exchange: pacifica, hyperliquid, lighter, or aster
symbolstringобязательный
Symbol to close (e.g., BTC, ETH)

trade_execute

Выполнить сделку. ВАЖНО: Всегда сначала вызывайте trade_preview и получайте явное подтверждение пользователя перед вызовом этого инструмента. Поддерживает рыночные и лимитные ордера.

Параметры

exchangestringобязательный
Exchange: pacifica, hyperliquid, lighter, or aster
orderTypeenum
Order type
pricestring
Limit price (required for limit orders)
reduceOnlyboolean
Reduce-only order (close position only)
sideenumобязательный
Order side
sizestringобязательный
Order size (base currency units)
symbolstringобязательный
Trading symbol (e.g., BTC, ETH, SOL)

trade_preview

Предварительный просмотр сделки БЕЗ исполнения. Возвращает ориентировочную цену исполнения, комиссии, влияние на маржу и проверки рисков. ВСЕГДА вызывайте это перед trade_execute и показывайте результат пользователю для подтверждения.

Параметры

exchangestringобязательный
Exchange: pacifica, hyperliquid, lighter, or aster
orderTypeenum
Order type
pricestring
Limit price (required for limit orders)
sideenumобязательный
Order side
sizestringобязательный
Order size (base currency units, e.g., '0.1' for 0.1 BTC)
symbolstringобязательный
Trading symbol (e.g., BTC, ETH, SOL)

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер превращает Claude в полноценного трейдера бессрочными фьючерсами на нескольких DEX одновременно. Он нужен, чтобы AI-агент сам собирал котировки, находил арбитражные возможности, выполнял ордера и управлял позициями — без ручного ввода команд в терминал. Вместо того, чтобы копаться в CLI, просто говоришь агенту, что сделать, и он делает.

Что он умеет?

Сервер собирает рыночные данные по четырём биржам: цены, стаканы, funding rate и доступные рынки. Сканирует арбитражные возможности, сравнивает открытые позиции, считает P&L, доходность от funding и годовые проценты. Показывает балансы, позиции, открытые ордера и риск-метрики по всем биржам сразу. Готовит сделки через превью с проверкой рисков, исполняет рыночные и лимитные ордера, закрывает позиции. Проверяет связь с биржами, подсказывает нужные команды по описанию цели и объясняет их.

Информация о сервере

Номер в рейтинге: #195
Звезд на Github: 35
Форков на Github: 7
Загрузок: 12 142
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 08.09 в 23:59
Идентификатор: Nw294HWSUzUzO5_L
Категории: Web3 и децентрализованные технологии, Блокчейн, Криптовалюты и Defi, Финансы