ByKaranteli

bykaranteli-mcp

Servidor MCP (Model Context Protocol) para datos en vivo de derivados cripto: tasas de funding, arbitraje de funding entre exchanges, presión de interés abierto, liquidaciones, opciones, flujos de ETF, Fear & Greed y dominancia de BTC.

67 herramientas de solo lectura y de cuenta sobre la API JSON pública de bykaranteli.com: las herramientas de datos de mercado solo leen, y las herramientas de alertas y listas de seguimiento actúan sobre tu propia cuenta mediante tu clave (Herramientas de cuenta). Desde 2026-09-10 la API solicita a los programas una clave de cuenta: una clave gratuita viene con cualquier cuenta verificada en https://bykaranteli.com/dashboard/api (30 solicitudes por minuto y 15,000 al mes, profundidad pública), y los planes Builder, Business y Scale aumentan la tasa y el uso justo mensual y desbloquean profundidad de miembro (LiqMap en siete marcos temporales, series de 5 minutos, el catálogo x402 incluido en el uso justo mensual). Configúrala como BYKARANTELI_API_KEY. Los datos cubren perpetuos USDT-M de Binance; el arbitraje de funding, liquidaciones, profundidad del libro de órdenes, opciones, posicionamiento y fondos de seguro añaden los otros exchanges que cada panel lista en bykaranteli.com/coverage.

Endpoint alojado (sin instalación)

Pega https://mcp.bykaranteli.com como conector personalizado en cualquier asistente compatible con MCP. Las mismas herramientas, nada que instalar. Cada llamada a herramienta necesita tu clave de cuenta (gratuita en https://bykaranteli.com/dashboard/api); conectar y listar las herramientas funciona sin una. La clave viaja de una de tres maneras:

• el encabezado de solicitud x-api-key: bk_... (conectores personalizados de claude.ai, Cursor, Claude Code);
• el encabezado de solicitud Authorization: Bearer bk_...;
• la dirección https://mcp.bykaranteli.com/?key=bk_... para clientes que no pueden enviar encabezados (ChatGPT). Trata esa dirección como una contraseña y revoca la clave si se filtra.

O inicia sesión con OAuth 2.1 donde el cliente lo ofrezca (conectores personalizados de claude.ai: Autenticación, Iniciar sesión; conectores de ChatGPT: OAuth): el cliente se registra (RFC 7591, PKCE S256), lo apruebas una vez en bykaranteli.com y se ejecuta con una clave de tu propia cuenta, que la página de Datos y API lista bajo aplicaciones conectadas. Descubrimiento: https://mcp.bykaranteli.com/.well-known/oauth-protected-resource.

Una cuenta gratuita cubre la API y el MCP alojado en un solo contador mensual; Builder y superiores ofrecen tasas más altas y profundidad de miembro.

Guía paso a paso para principiantes: https://bykaranteli.com/guide/connect

Inicio rápido

Claude Code

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_..." }
    }
  }
}

Cursor / otros clientes MCP

Cualquier cliente MCP stdio funciona: comando npx, argumentos ["-y", "bykaranteli-mcp"], entorno BYKARANTELI_API_KEY.

Requiere Node.js 18 o superior.

Herramientas

Herramienta	Qué responde
get_market_indices	"¿Cuál es el índice de Fear & Greed hoy?", "¿Cuál es la dominancia de BTC ahora mismo?"
get_funding_heatmap	"¿Cuáles son las tasas de funding ahora mismo?", "¿Cuál es el funding de SOL?"
get_funding_arbitrage	"¿Hay oportunidades de arbitraje de funding?", "¿Mejor exchange para long/short BTC por carry?"
get_pressure_scores	"¿Qué monedas están sobre-apalancadas / saturadas ahora mismo?"
get_top_movers	"¿Mayores picos de OI hoy?", "¿Funding más extremo ahora mismo?"
get_liquidations	"¿Cuánto se liquidó hoy?", "¿Se liquidaron más longs o shorts esta semana?"
get_liquidation_leaderboard	"¿Cuál fue la mayor liquidación hoy?", "¿Cuándo se agrupan las liquidaciones, en horas de Asia o EE. UU.?"
get_insurance_funds	"¿Qué tan grande es el fondo de seguro de Binance?", "¿Algún fondo de seguro de exchange se redujo esta semana?"
get_tokenized_stocks	"¿Cuánto Tesla tokenizado existe en cadena?", "¿Qué acción tokenizada cotiza más lejos de la acción real?", "¿Qué precio valoró el suministro de este wrapper?" (price_source, totals.priced_by)
get_etf_flows	"¿Compraron o vendieron los ETF de Bitcoin ayer?", "¿Flujo acumulado de entrada de ETH ETF?"
get_cot_positioning	"¿Están los fondos de cobertura largos o cortos en Bitcoin?", "¿Qué mostró el informe COT?"
get_options_snapshot	"¿Dónde están los muros de opciones de BTC?", "¿Cuál es el DVOL / el nivel de gamma cero?"
get_coinbase_premium	"¿Están los inversores de EE. UU. comprando Bitcoin?", "¿Qué paga el trade de basis?"
get_flow_toxicity	"¿Se está acumulando flujo de órdenes tóxico?", "¿Cuál es el VPIN de BTC ahora mismo?"
get_options_flow	"¿Qué están comprando los grandes jugadores de opciones?", "¿Hay operaciones en bloque hoy?"
get_slippage	"¿Cuánto deslizamiento en una orden de mercado de $1M?", "¿Qué libro es el más delgado?"
get_fomc_impact	"¿Qué hace BTC en días de la Fed?", "¿Cuándo es la próxima reunión del FOMC?"
get_liquidation_cascades	"¿Qué causó esa caída?", "¿Quién fue liquidado esta semana?"
get_open_interest	"¿Está entrando apalancamiento al mercado?", "¿Se están acumulando cortos en XRP?"
get_psi_charge	"¿En qué estado de liquidez está el mercado?", "¿Se está desplegando el dinero estacionado?"
get_theme_indices	"¿Qué narrativa cripto lidera: IA, RWA, DePIN, memes, L2s, DeFi?"
get_factor_board	"¿Qué indicadores están en una banda inusual hoy, y qué siguió históricamente?"
get_venue_markets	"¿Interés abierto total de BTC entre exchanges?", "¿Cuál es la cuota DEX del OI de perpetuos?", "¿Está USDT fuera de paridad en algún lugar?"
get_leverage_tiers	"¿Cuánto apalancamiento permite Bybit en SOL?", "¿Qué exchange tiene el mayor apalancamiento máximo para DOGE?", "¿Algún exchange recortó el apalancamiento en una moneda esta semana?"
get_withdrawal_status	"¿Ha pausado KuCoin los retiros de USDT?", "¿Red más barata para retirar USDT de Gate?", "¿Qué exchanges tienen retiros cerrados ahora mismo?"
get_venue_profile	"¿Qué registras sobre Bybit?", "¿Cuántos contratos lista OKX?", "¿Está HTX activo, y qué pasó allí esta semana?"
get_settlements	"¿Qué vence esta semana?", "¿Cuándo es el próximo trimestral de BTC en OKX?", "¿A qué precio se liquidó el futuro de septiembre?"
get_borrow_rates	"¿Cuánto cuesta pedir prestado USDT en Binance?", "¿Exchange más barato para pedir prestado ETH?", "¿Está aumentando el préstamo de stablecoins?"
get_fee_table	"¿Cuáles son las tarifas de perpetuos de Bitget?", "¿Qué exchange tiene la tarifa taker más baja?", "¿Algún exchange cambió tarifas esta semana?"
get_lead_lag	"¿Coinbase o Binance se mueven primero?"
get_iv_surface	"¿Cuál es la volatilidad implícita de BTC por vencimiento?", "¿Es cara la protección a la baja (skew)?"
get_whale_tape	"¿Están las ballenas comprando o vendiendo ahora mismo?"
get_correlations	"¿Qué tan correlacionado está SOL con BTC en 30 días?"
get_new_listings	"¿Qué perpetuos se listaron esta semana, y dónde primero?"
get_macro_liquidity	"¿Qué está haciendo el balance de la Fed / RRP / suministro de stablecoins?"
get_network_health	"¿Hashrate de Bitcoin, dificultad, tarifas, mempool ahora mismo?"
get_tradfi_board	"¿Tasa de funding del perpetuo TSLA? ¿Qué exchanges listan perpetuos NVDA? ¿Está abierta la sesión de acciones?"
get_rsi_heatmap	"¿Qué monedas están sobrevendidas en el diario? ¿RSI de BTC en 4h y 1s?"
get_hl_whales	"¿Están las ballenas de Hyperliquid netas largas en BTC? ¿Qué acaban de cambiar las cuentas más grandes?"
get_positioning	"¿Ratio long/short de BTC en Binance? ¿Están los mejores traders netos cortos en ETH? ¿CVD hoy?"
get_coverage	"¿Qué exchanges están detrás de tus totales de liquidación? ¿Qué tan frescos están los datos?"
get_orderbook_depth	"¿Dónde está el muro de compra más grande de BTC? ¿Qué tan profundo está ETH dentro del 2% en Coinbase vs Binance?"
get_jupiter_perps	"¿Cuánto OI largo vs corto hay en los perpetuos SOL de Jupiter? ¿Quién lideró Jupiter esta semana? ¿Cuál es el APR de JLP?"
get_solana_perps	"¿Qué DEX de perpetuos de Solana tiene más interés abierto? ¿Cuál es el funding de BTC y volumen de 24h de Pacifica? ¿Interés abierto de SOL en Phoenix? ¿GM Trade versus Jupiter?"
get_turkey_premium	"¿Cuánto pagan los compradores de liras por bitcoin por encima del precio mundial? ¿Cuál es el Índice de Prima de Turquía y su puntuación ahora mismo? ¿Qué exchange turco es el más caro? ¿Cuál es USDT/TRY frente a la tasa oficial?"
get_data_proof	"¿Puedo verificar que un número de ByKaranteli no se cambió después? Muestra la prueba en cadena para el funding de BTC ahora mismo. ¿Qué transacción de Solana selló el epoch más reciente?"
get_cycle_indicators	"¿Ha cruzado el Pi Cycle? ¿Mayer Multiple y Puell hoy?"
get_altseason	"¿Es temporada de altcoins?", "¿Cuál es el índice de temporada de altcoins?"
get_metric_context	"¿Es extremo el funding de hoy históricamente?", "¿Dónde se sitúa esta lectura en su distribución?"
get_quantum_exposure	"¿Cuánto Bitcoin es vulnerable a la computación cuántica?", "¿Cuál es la exposición P2PK?"
get_liqmap	"¿Dónde están los clústeres de liquidación de BTC?", "¿Dónde se liquidarían los longs apalancados?"
get_market_profile	"¿Dónde está el punto de control de BTC hoy?", "¿Cuál fue el área de valor de ayer?", "¿Qué POC desnudos siguen sin probarse?"
get_options_chain	"¿Cómo se movió el interés abierto de BTC por strike hoy?", "¿Dónde está el IV ATM de ETH hora a hora?", "¿Qué vencimiento ganó más interés abierto en 24h?"
get_hl_positions	"¿Dónde se liquidan las ballenas de Hyperliquid en BTC?", "¿Cuánto nocional rastreado está por debajo del precio?", "¿Coincide el modelo con las posiciones rastreadas?"
get_venue_share	"¿Qué exchange tuvo más liquidaciones esta semana?", "¿Cómo se divide el interés abierto de perpetuos por exchange?"
get_tradfi_gaps	"¿Qué hizo el perpetuo TSLA durante el fin de semana?", "¿Qué tan grande fue la brecha de apertura del lunes en NVDA?", "¿Qué tan separados estuvieron los exchanges durante la noche?"
get_series	"¿Interés abierto de BTC por hora durante la última semana?", "¿Funding de ETH en OKX desde el 1 de septiembre?", "¿Prima diaria de Coinbase este mes?" (lista de métricas, unidades y períodos más finos: https://bykaranteli.com/api/series/metrics)

Todas las respuestas de mercado son JSON y llevan una marca de tiempo generatedAt, una URL source a la página legible para humanos y un bloque provenance: source_page, api_path, el propio generated_at de la respuesta, fetched_at, y cuando la respuesta los lleva, el venues detrás del número, coverage (full, sampled o mixed), stale_venues y recorded_since, más la página proof (https://bykaranteli.com/proof). Un campo que la respuesta no lleva se omite, nunca se rellena. Los símbolos aceptan tanto BTCUSDT como BTC desnudo.

Herramientas de cuenta (alertas y listas de seguimiento)

Estas herramientas leen y cambian tu propia cuenta de ByKaranteli con la misma clave: las recetas de alerta que te notifican por Telegram, correo electrónico, push o webhook, y tus listas de seguimiento. Nunca operan, mueven fondos ni tocan otra cuenta.

Herramienta	Qué hace
parse_alert_text	Convierte "funding de BTC por encima de 0.05%" o "avísame cuando ETH caiga 5% en un día" en la receta exacta, con una confianza y lo que el texto dejó abierto. Basada en reglas; no guarda nada, nunca inventa un umbral.
list_alert_recipes	Lista tus recetas de alerta con sus condiciones, alcance, canales y cuándo se disparó cada una por última vez.
create_alert_recipe	Guarda una receta de alerta (escribe en tu cuenta).
delete_alert_recipe	Elimina una de tus recetas de alerta por id (escribe en tu cuenta).
list_watchlists	Lista tus listas de seguimiento y los símbolos en cada una.
add_watchlist_symbol	Añade un símbolo a tu lista predeterminada o a la lista que nombres (escribe en tu cuenta).
remove_watchlist_symbol	Elimina un símbolo de una lista (escribe en tu cuenta).
list_tracked_addresses	Lista las direcciones de Hyperliquid que sigues, con sus últimas posiciones (lee tu cuenta).
add_tracked_address	Sigue una dirección de Hyperliquid para alertas de posición (escribe en tu cuenta; Terminal y superior).
remove_tracked_address	Deja de seguir una dirección (escribe en tu cuenta).

• Las herramientas de escritura llevan readOnlyHint: false (y destructiveHint: true para las dos que eliminan algo), para que los clientes que preguntan antes de un cambio pregunten.
• Cuántas recetas mantiene una cuenta sigue su plan; más allá de eso, create_alert_recipe responde con el límite en lugar de guardar.
• Cada llamada cuenta en el plan de la clave como cualquier otra solicitud; las escrituras también están limitadas por tasa por clave, y cada escritura se registra en la cuenta con la clave que la hizo.
• Las recetas y los cambios de listas de seguimiento aparecen de inmediato en https://bykaranteli.com/dashboard/alerts y https://bykaranteli.com/dashboard/watchlist.

Configuración

Variable de entorno	Predeterminado	Propósito
BYKARANTELI_API_KEY	ninguno	Clave de cuenta (bk_...) enviada como Authorization: Bearer. Gratuita en https://bykaranteli.com/dashboard/api; requerida para programas desde 2026-09-10
BYKARANTELI_BASE_URL	https://bykaranteli.com	Sobrescribe el host de la API (solo pruebas). La clave se envía a cualquier host que esto nombre, así que apúntalo solo a un servidor en el que confíes.

Notas de datos

• El motor de señales se retiró en septiembre de 2026; este servidor publica únicamente datos de mercado registrados, sin señales de trading ni afirmaciones de rendimiento.
• Los datos de financiación, interés abierto (OI) y presión se actualizan cada 15 a 30 minutos; los índices cada 30 minutos.
• Nada de esto es asesoramiento financiero. Consulta bykaranteli.com/risk-guide.

Desarrollo

npm install
npm run build
node dist/index.js   # speaks MCP over stdio

Notas de versión por versión: CHANGELOG.md.

Licencia

Servidor: MIT. Datos: uso personal y de investigación con atribución "ByKaranteli (bykaranteli.com)"; uso comercial con el plan Business. Texto de licencia: https://bykaranteli.com/data#license.

Planes y profundidad de pago

Plan	Tasa	Mensual	Profundidad
API gratuita	30 / min	15,000	páginas públicas
Terminal	60 / min	150,000	páginas públicas
Builder	300 / min	1,000,000 de uso justo	profundidad de miembro, catálogo x402 incluido, cada llamada cuenta como 10 solicitudes del uso justo mensual
Business	1,200 / min	3,000,000 de uso justo	profundidad de miembro, licencia comercial, catálogo x402 incluido, cada llamada cuenta como 10 solicitudes del uso justo mensual, volumen mensual
Scale	3,000 / min	10,000,000 de uso justo	profundidad de miembro, redistribución derivada, catálogo x402 incluido, cada llamada cuenta como 10 solicitudes del uso justo mensual, datos brutos diarios

Precios: https://bykaranteli.com/pricing

Una clave gratuita o de Terminal que supere su cifra mensual recibe 429 hasta que el mes se reinicie. Una clave de pago que supere su uso justo nunca se detiene: responde a la tasa gratuita (30 por minuto) hasta que el mes se reinicie, con x-quota-state: slow en cada respuesta.

Tabla completa: https://bykaranteli.com/developers#tiers. Para historial registrado y registros brutos más allá de las instantáneas en vivo, bykaranteli.com también expone endpoints x402 de pago por llamada para agentes anónimos (USDC en Solana o Base, con precio por llamada, sin cuenta): https://bykaranteli.com/developers#x402 · catálogo de máquinas: https://bykaranteli.com/api/x402. Las claves Builder, Business y Scale llaman a esas rutas sin pago; cada llamada cuenta como 10 solicitudes del uso justo mensual.