Servidor MCP 0xArchive

Consulta datos del mercado cripto en Hyperliquid, HIP-3 y Lighter.xyz usando lenguaje natural en Claude.

79 herramientas que cubren libros de órdenes, operaciones, velas, tasas de financiación, interés abierto, liquidaciones, datos a nivel de orden L4, métricas de calidad de datos y autenticación basada en billetera, desde abril de 2023 hasta tiempo real.

Inicio rápido (30 segundos)

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

Luego pregúntale a Claude: "¿Cuál es la tasa de financiación actual de BTC?"

Ejemplos de uso

Pregúntale a Claude...	Herramienta que se ejecuta
"Dame un resumen del mercado de BTC"	`get_summary`
"Muestra velas de ETH de 4h de la última semana"	`get_candles`
"¿Cuál es la tasa de financiación actual para SOL?"	`get_funding_current`
"Compara la financiación de BTC en Hyperliquid vs Lighter"	`get_funding_current` + `get_lighter_funding_current`
"Muéstrame las liquidaciones de SOL en las últimas 24 horas"	`get_liquidations`
"Obtén el libro de órdenes de BTC con 20 niveles"	`get_orderbook`
"¿Algún incidente de datos este mes?"	`get_data_incidents`
"¿Cuál es el precio de km:US500 en HIP-3?"	`get_hip3_summary`
"Muéstrame el informe de SLA de enero de 2026"	`get_data_sla`

Configuración (detallada)

1. Instalar y compilar

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

2. Obtener una clave API

Regístrate en 0xarchive.io y genera una clave API en el panel de control. O usa las herramientas web3_challenge y web3_signup para obtener una clave API gratuita solo con una billetera Ethereum, sin necesidad de navegador.

3. Añadir a 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. Añadir a Claude Desktop

Añádelo a tu 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"
      }
    }
  }
}

Herramientas disponibles (79)

Hyperliquid

Herramienta	Descripción
`get_instruments`	Listar todos los instrumentos perp/spot de Hyperliquid
`get_instrument`	Obtener un solo instrumento de Hyperliquid por moneda
`get_orderbook`	Instantánea actual del libro de órdenes L2
`get_orderbook_history`	Instantáneas históricas del libro de órdenes
`get_trades`	Historial de operaciones/ejecuciones
`get_candles`	Datos de velas OHLCV
`get_funding_current`	Tasa de financiación actual
`get_funding_history`	Historial de tasas de financiación
`get_open_interest`	Interés abierto actual
`get_open_interest_history`	Historial de interés abierto
`get_liquidations`	Historial de liquidaciones
`get_liquidations_by_user`	Liquidaciones para una dirección de usuario específica
`get_liquidation_volume`	Volumen de liquidación agregado (cubetas USD)
`get_freshness`	Frescura y retraso de datos por moneda
`get_summary`	Resumen de mercado combinado (precio, financiación, OI, volumen, liquidaciones)
`get_price_history`	Historial de precio mark/oracle/mid

Hyperliquid L4 (Nivel de orden)

Herramienta	Descripción
`get_order_history`	Historial de órdenes con atribución de usuario (nivel Build+)
`get_order_flow`	Métricas agregadas de colocación, cancelación y ejecución de órdenes (nivel Build+)
`get_tpsl`	Historial de órdenes TP/SL con precios de activación y estado de activación (nivel Pro+)
`get_l4_orderbook`	Reconstrucción del libro de órdenes L4 en una marca de tiempo específica (nivel Pro+)
`get_l4_diffs`	Cambios brutos a nivel de orden (nuevos, modificados, cancelados, ejecutados) en un rango de tiempo (nivel Pro+)
`get_l4_orderbook_history`	Puntos de control periódicos del libro de órdenes completo a nivel de orden (nivel Pro+)

Hyperliquid L2 (Profundidad completa)

Herramienta	Descripción
`get_l2_orderbook`	Libro de órdenes L2 de profundidad completa derivado de L4 (nivel Build+)
`get_l2_orderbook_history`	Instantáneas históricas del libro de órdenes L2 de profundidad completa (nivel Build+)
`get_l2_diffs`	Diferencias a nivel de tick L2 (nivel Pro+)

HIP-3 (Perps de constructor)

Herramienta	Descripción
`get_hip3_instruments`	Listar instrumentos HIP-3
`get_hip3_instrument`	Obtener un solo instrumento HIP-3 por moneda
`get_hip3_orderbook`	Libro de órdenes actual de HIP-3
`get_hip3_orderbook_history`	Instantáneas históricas del libro de órdenes HIP-3
`get_hip3_trades`	Historial de operaciones HIP-3
`get_hip3_trades_recent`	Operaciones HIP-3 más recientes
`get_hip3_candles`	Datos de velas HIP-3
`get_hip3_funding_current`	Tasa de financiación actual de HIP-3
`get_hip3_funding`	Historial de financiación de HIP-3
`get_hip3_open_interest`	Interés abierto actual de HIP-3
`get_hip3_open_interest_history`	Historial de interés abierto de HIP-3
`get_hip3_liquidations`	Eventos de liquidación de HIP-3 (desde feb 2026)
`get_hip3_liquidation_volume`	Volumen de liquidación agregado de HIP-3 (cubetas USD, desde feb 2026)
`get_hip3_freshness`	Frescura y retraso de datos HIP-3 por moneda
`get_hip3_summary`	Resumen de mercado combinado de HIP-3
`get_hip3_price_history`	Historial de precio mark/oracle/mid de HIP-3

HIP-3 L4 (Nivel de orden)

Herramienta	Descripción
`get_hip3_order_history`	Historial de órdenes HIP-3 con atribución de usuario (nivel Build+)
`get_hip3_order_flow`	Métricas agregadas de colocación, cancelación y ejecución de órdenes HIP-3 (nivel Build+)
`get_hip3_tpsl`	Historial de órdenes TP/SL de HIP-3 con precios de activación y estado de activación (nivel Pro+)
`get_hip3_l4_orderbook`	Reconstrucción del libro de órdenes L4 de HIP-3 en una marca de tiempo específica (nivel Pro+)
`get_hip3_l4_diffs`	Cambios brutos a nivel de orden de HIP-3 en un rango de tiempo (nivel Pro+)
`get_hip3_l4_orderbook_history`	Puntos de control periódicos del libro de órdenes completo a nivel de orden de HIP-3 (nivel Pro+)

HIP-3 L2 (Profundidad completa)

Herramienta	Descripción
`get_hip3_l2_orderbook`	Libro de órdenes L2 de profundidad completa de HIP-3 derivado de L4 (nivel Build+)
`get_hip3_l2_orderbook_history`	Historial del libro de órdenes L2 de profundidad completa de HIP-3 (nivel Build+)
`get_hip3_l2_diffs`	Diferencias a nivel de tick L2 de HIP-3 (nivel Pro+)

Lighter.xyz

Herramienta	Descripción
`get_lighter_instruments`	Listar instrumentos Lighter
`get_lighter_instrument`	Obtener un solo instrumento Lighter por moneda
`get_lighter_orderbook`	Libro de órdenes actual de Lighter
`get_lighter_orderbook_history`	Instantáneas históricas del libro de órdenes Lighter
`get_lighter_trades`	Historial de operaciones Lighter
`get_lighter_trades_recent`	Operaciones Lighter más recientes
`get_lighter_candles`	Datos de velas Lighter
`get_lighter_funding_current`	Tasa de financiación actual de Lighter
`get_lighter_funding`	Historial de financiación de Lighter
`get_lighter_open_interest`	Interés abierto actual de Lighter
`get_lighter_open_interest_history`	Historial de interés abierto de Lighter
`get_lighter_freshness`	Frescura y retraso de datos Lighter por moneda
`get_lighter_summary`	Resumen de mercado combinado de Lighter
`get_lighter_price_history`	Historial de precio mark/oracle/mid de Lighter

Lighter L3 (Nivel de orden)

Herramienta	Descripción
`get_lighter_l3_orderbook`	Libro de órdenes actual a nivel de orden L3 con IDs de orden y direcciones de usuario (nivel Pro+)
`get_lighter_l3_orderbook_history`	Instantáneas históricas del libro de órdenes L3 con órdenes individuales (nivel Pro+)

Calidad de datos

Herramienta	Descripción
`get_data_quality_status`	Salud del sistema en todos los exchanges
`get_data_coverage`	Cobertura de datos (primero/último, registros, integridad)
`get_exchange_coverage`	Cobertura para un exchange específico
`get_symbol_coverage`	Cobertura por símbolo con detección de brechas
`get_data_incidents`	Historial de interrupciones y degradación
`get_incident`	Detalles de un solo incidente por ID
`get_data_latency`	Latencia de WebSocket/REST y frescura de datos
`get_data_sla`	Informe mensual de cumplimiento de SLA

Autenticación Web3

Herramienta	Descripción
`web3_challenge`	Obtener un mensaje de desafío SIWE para una dirección de billetera
`web3_signup`	Crear una cuenta de nivel gratuito y clave API con un mensaje SIWE firmado
`web3_list_keys`	Listar todas las claves API para una billetera
`web3_revoke_key`	Revocar una clave API específica
`web3_subscribe`	Suscribirse a un nivel de pago (build/pro) mediante pago x402 USDC en Base

Flujo de nivel gratuito: web3_challenge (obtener mensaje SIWE) → firmar con personal_sign (EIP-191) → web3_signup (enviar firma) → recibir clave API.

Flujo de nivel de pago (x402): web3_subscribe con nivel → devuelve 402 con precios → firmar transferencia USDC (EIP-3009 en Base) → web3_subscribe de nuevo con payment_signature → recibir clave API + suscripción.

Niveles de precios

Algunos endpoints requieren un plan de pago. El servidor devuelve mensajes de error claros con orientación sobre cómo actualizar cuando se alcanzan los límites del nivel.

Nivel	Precio	Acceso
Gratuito	$0/mes	Datos históricos solo de BTC
Build	$49/mes	Todas las monedas, API REST, 25 subs WS
Pro	$199/mes	Profundidad total del libro de órdenes, 100 subs WS
Enterprise	Personalizado	Datos de tick, 200 subs WS

Actualiza en 0xarchive.io/pricing.

Anotaciones de herramientas

Las 79 herramientas llevan anotaciones MCP para que los clientes puedan razonar sobre la seguridad y el comportamiento de reintento.

Herramientas de datos de mercado (74):

Anotación	Valor	Significado
`readOnlyHint`	`true`	Las herramientas nunca modifican datos
`destructiveHint`	`false`	Sin efectos secundarios destructivos
`idempotentHint`	`true`	Seguro para reintentar en caso de fallo
`openWorldHint`	`true`	Consulta una API externa

Herramientas Web3 (5): readOnlyHint: false, idempotentHint: false: estas crean cuentas, claves y suscripciones.

Todas las herramientas también declaran un outputSchema para que los clientes puedan validar las respuestas estructuradas.

Valores predeterminados inteligentes

Rango de tiempo: Por defecto, las últimas 24 horas si no se especifica
Límite: Por defecto, 100 registros
Intervalo: Por defecto, 1h para velas
Paginación: Devuelve un cursor para la siguiente página cuando hay más datos disponibles
Marcas de tiempo: Acepta tanto milisegundos Unix como cadenas ISO 8601

Descargas de datos masivos

Para exportaciones de datos a gran escala (libros de órdenes completos, historial de operaciones completo, etc.), utiliza la exportación masiva S3 Parquet disponible en 0xarchive.io/data. El Explorador de Datos te permite seleccionar rangos de tiempo, símbolos y tipos de datos, y luego descargar archivos Parquet comprimidos directamente. Las herramientas MCP son mejores para consultas puntuales y extracciones de datos de tamaño moderado; para necesidades masivas, el Explorador de Datos es significativamente más rápido.

0xarchive-mcp