MCP-сервер 0xArchive

Запрашивайте рыночные данные криптовалют на Hyperliquid, HIP-3 и Lighter.xyz, используя естественный язык в Claude.

79 инструментов, охватывающих биржевые стаканы, сделки, свечи, ставки финансирования, открытый интерес, ликвидации, данные уровня L4, метрики качества данных и аутентификацию на основе кошелька — с апреля 2023 года по настоящее время.

Быстрый старт (30 секунд)

git clone https://github.com/0xArchiveIO/0xarchive-mcp.git
cd 0xarchive-mcp && npm install && npm run build
claude mcp add 0xarchive -s user -t stdio -e OXARCHIVE_API_KEY=0xa_your_api_key -- node $(pwd)/build/index.js

Затем спросите Claude: "Какая сейчас ставка финансирования по BTC?"

Примеры использования

Спросите Claude...	Запускаемый инструмент
"Дай мне сводку по рынку BTC"	`get_summary`
"Покажи 4-часовые свечи ETH за прошлую неделю"	`get_candles`
"Какая сейчас ставка финансирования для SOL?"	`get_funding_current`
"Сравни финансирование BTC на Hyperliquid и Lighter"	`get_funding_current` + `get_lighter_funding_current`
"Покажи ликвидации SOL за последние 24 часа"	`get_liquidations`
"Получи стакан BTC с 20 уровнями"	`get_orderbook`
"Были ли инциденты с данными в этом месяце?"	`get_data_incidents`
"Какая цена km:US500 на HIP-3?"	`get_hip3_summary`
"Покажи отчет SLA за январь 2026 года"	`get_data_sla`

Настройка (подробно)

1. Установка и сборка

git clone https://github.com/0xArchiveIO/0xarchive-mcp.git
cd 0xarchive-mcp
npm install
npm run build

2. Получение API-ключа

Зарегистрируйтесь на 0xarchive.io и создайте API-ключ в панели управления. Или используйте инструменты web3_challenge и web3_signup, чтобы получить бесплатный API-ключ, имея только Ethereum-кошелек — браузер не требуется.

3. Добавление в Claude Code

claude mcp add 0xarchive -s user -t stdio -e OXARCHIVE_API_KEY=0xa_your_api_key -- node /absolute/path/to/0xarchive-mcp/build/index.js

4. Добавление в Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "0xarchive": {
      "command": "node",
      "args": ["/absolute/path/to/0xarchive-mcp/build/index.js"],
      "env": {
        "OXARCHIVE_API_KEY": "0xa_your_api_key"
      }
    }
  }
}

Доступные инструменты (79)

Hyperliquid

Инструмент	Описание
`get_instruments`	Список всех бессрочных/спотовых инструментов Hyperliquid
`get_instrument`	Получить один инструмент Hyperliquid по монете
`get_orderbook`	Текущий снимок стакана L2
`get_orderbook_history`	Исторические снимки стакана
`get_trades`	История сделок/исполнений
`get_candles`	Данные свечей OHLCV
`get_funding_current`	Текущая ставка финансирования
`get_funding_history`	История ставок финансирования
`get_open_interest`	Текущий открытый интерес
`get_open_interest_history`	История открытого интереса
`get_liquidations`	История ликвидаций
`get_liquidations_by_user`	Ликвидации для конкретного адреса пользователя
`get_liquidation_volume`	Агрегированный объем ликвидаций (в USD)
`get_freshness`	Свежесть и задержка данных по монетам
`get_summary`	Сводка по рынку (цена, финансирование, OI, объем, ликвидации)
`get_price_history`	История цен (mark/oracle/mid)

Hyperliquid L4 (Уровень ордеров)

Инструмент	Описание
`get_order_history`	История ордеров с атрибуцией пользователя (тариф Build+)
`get_order_flow`	Агрегированные метрики размещения, отмены и исполнения ордеров (тариф Build+)
`get_tpsl`	История TP/SL ордеров с ценами триггеров и статусом (тариф Pro+)
`get_l4_orderbook`	Реконструкция стакана L4 на конкретный момент времени (тариф Pro+)
`get_l4_diffs`	Изменения на уровне ордеров (новые, измененные, отмененные, исполненные) за период (тариф Pro+)
`get_l4_orderbook_history`	Периодические полные контрольные точки стакана L4 (тариф Pro+)

Hyperliquid L2 (Полная глубина)

Инструмент	Описание
`get_l2_orderbook`	Стакан L2 полной глубины, полученный из L4 (тариф Build+)
`get_l2_orderbook_history`	Исторические снимки стакана L2 полной глубины (тариф Build+)
`get_l2_diffs`	Различия тикового уровня L2 (тариф Pro+)

HIP-3 (Builder Perps)

Инструмент	Описание
`get_hip3_instruments`	Список инструментов HIP-3
`get_hip3_instrument`	Получить один инструмент HIP-3 по монете
`get_hip3_orderbook`	Текущий стакан HIP-3
`get_hip3_orderbook_history`	Исторические снимки стакана HIP-3
`get_hip3_trades`	История сделок HIP-3
`get_hip3_trades_recent`	Последние сделки HIP-3
`get_hip3_candles`	Данные свечей HIP-3
`get_hip3_funding_current`	Текущая ставка финансирования HIP-3
`get_hip3_funding`	История финансирования HIP-3
`get_hip3_open_interest`	Текущий открытый интерес HIP-3
`get_hip3_open_interest_history`	История открытого интереса HIP-3
`get_hip3_liquidations`	События ликвидации HIP-3 (с фев 2026)
`get_hip3_liquidation_volume`	Агрегированный объем ликвидаций HIP-3 (с фев 2026)
`get_hip3_freshness`	Свежесть и задержка данных HIP-3 по монетам
`get_hip3_summary`	Сводка по рынку HIP-3
`get_hip3_price_history`	История цен HIP-3 (mark/oracle/mid)

HIP-3 L4 (Уровень ордеров)

Инструмент	Описание
`get_hip3_order_history`	История ордеров HIP-3 с атрибуцией пользователя (тариф Build+)
`get_hip3_order_flow`	Агрегированные метрики ордеров HIP-3 (тариф Build+)
`get_hip3_tpsl`	История TP/SL ордеров HIP-3 (тариф Pro+)
`get_hip3_l4_orderbook`	Реконструкция стакана L4 HIP-3 (тариф Pro+)
`get_hip3_l4_diffs`	Изменения на уровне ордеров HIP-3 за период (тариф Pro+)
`get_hip3_l4_orderbook_history`	Периодические контрольные точки стакана L4 HIP-3 (тариф Pro+)

HIP-3 L2 (Полная глубина)

Инструмент	Описание
`get_hip3_l2_orderbook`	Стакан L2 полной глубины HIP-3 (тариф Build+)
`get_hip3_l2_orderbook_history`	История стакана L2 полной глубины HIP-3 (тариф Build+)
`get_hip3_l2_diffs`	Различия тикового уровня L2 HIP-3 (тариф Pro+)

Lighter.xyz

Инструмент	Описание
`get_lighter_instruments`	Список инструментов Lighter
`get_lighter_instrument`	Получить один инструмент Lighter по монете
`get_lighter_orderbook`	Текущий стакан Lighter
`get_lighter_orderbook_history`	Исторические снимки стакана Lighter
`get_lighter_trades`	История сделок Lighter
`get_lighter_trades_recent`	Последние сделки Lighter
`get_lighter_candles`	Данные свечей Lighter
`get_lighter_funding_current`	Текущая ставка финансирования Lighter
`get_lighter_funding`	История финансирования Lighter
`get_lighter_open_interest`	Текущий открытый интерес Lighter
`get_lighter_open_interest_history`	История открытого интереса Lighter
`get_lighter_freshness`	Свежесть и задержка данных Lighter по монетам
`get_lighter_summary`	Сводка по рынку Lighter
`get_lighter_price_history`	История цен Lighter (mark/oracle/mid)

Lighter L3 (Уровень ордеров)

Инструмент	Описание
`get_lighter_l3_orderbook`	Текущий стакан L3 с ID ордеров и адресами (тариф Pro+)
`get_lighter_l3_orderbook_history`	Исторические снимки стакана L3 с отдельными ордерами (тариф Pro+)

Качество данных

Инструмент	Описание
`get_data_quality_status`	Состояние системы на всех биржах
`get_data_coverage`	Охват данных (начало/конец, записи, полнота)
`get_exchange_coverage`	Охват для конкретной биржи
`get_symbol_coverage`	Охват по символам с обнаружением пробелов
`get_data_incidents`	История сбоев и деградации
`get_incident`	Детали инцидента по ID
`get_data_latency`	Задержка WebSocket/REST и свежесть данных
`get_data_sla`	Ежемесячный отчет о соответствии SLA

Web3-аутентификация

Инструмент	Описание
`web3_challenge`	Получить сообщение SIWE для адреса кошелька
`web3_signup`	Создать бесплатный аккаунт и API-ключ с подписью SIWE
`web3_list_keys`	Список всех API-ключей для кошелька
`web3_revoke_key`	Отозвать конкретный API-ключ
`web3_subscribe`	Подписка на платный тариф через платеж x402 USDC в сети Base

Бесплатный поток: web3_challenge (получить сообщение SIWE) → подписать через personal_sign (EIP-191) → web3_signup (отправить подпись) → получить API-ключ.

Платный поток (x402): web3_subscribe с тарифом → возвращает 402 с ценой → подписать перевод USDC (EIP-3009 в Base) → web3_subscribe снова с payment_signature → получить API-ключ + подписку.

Тарифные планы

Некоторые эндпоинты требуют платной подписки. Сервер возвращает понятные сообщения об ошибках с рекомендациями по обновлению при достижении лимитов.

Тариф	Цена	Доступ
Free	$0/мес	Исторические данные только по BTC
Build	$49/мес	Все монеты, REST API, 25 WS-подписок
Pro	$199/мес	Полная глубина стакана, 100 WS-подписок
Enterprise	Индивид.	Тиковые данные, 200 WS-подписок

Обновите тариф на 0xarchive.io/pricing.

Аннотации инструментов

Все 79 инструментов содержат аннотации MCP, чтобы клиенты могли оценивать безопасность и поведение при повторных попытках.

Инструменты рыночных данных (74):

Аннотация	Значение	Смысл
`readOnlyHint`	`true`	Инструменты никогда не изменяют данные
`destructiveHint`	`false`	Нет деструктивных побочных эффектов
`idempotentHint`	`true`	Безопасно повторять при сбое
`openWorldHint`	`true`	Запрашивает внешний API

Web3-инструменты (5): readOnlyHint: false, idempotentHint: false — они создают аккаунты, ключи и подписки.

Все инструменты также объявляют outputSchema, чтобы клиенты могли проверять структурированные ответы.

Умные значения по умолчанию

Временной диапазон: По умолчанию последние 24 часа, если не указано иное
Лимит: По умолчанию 100 записей
Интервал: По умолчанию 1 час для свечей
Пагинация: Возвращает курсор для следующей страницы, если данных больше
Временные метки: Принимает как миллисекунды Unix, так и строки ISO 8601

Массовая загрузка данных

Для крупномасштабного экспорта данных (полные стаканы, полная история сделок и т.д.) используйте массовый экспорт S3 Parquet, доступный на 0xarchive.io/data. Data Explorer позволяет выбирать временные диапазоны, символы и типы данных, а затем напрямую загружать сжатые файлы Parquet. Инструменты MCP лучше всего подходят для точечных запросов и получения данных среднего объема; для массовых нужд Data Explorer значительно быстрее.

0xarchive-mcp