ByKaranteli

bykaranteli-mcp

Servidor MCP (Model Context Protocol) para dados ao vivo de derivativos de criptomoedas: taxas de funding, arbitragem de funding entre exchanges, pressão de open interest, liquidações, opções, fluxos de ETF, Fear & Greed e dominância do BTC.

67 ferramentas somente leitura e de conta sobre a API JSON pública de bykaranteli.com: as ferramentas de dados de mercado apenas leem, e as ferramentas de alertas e watchlist agem na sua própria conta através da sua chave (Ferramentas de conta). Desde 2026-09-10 a API exige que programas usem uma chave de conta: uma chave gratuita vem com qualquer conta verificada em https://bykaranteli.com/dashboard/api (30 requisições por minuto e 15.000 por mês, profundidade pública), e os planos Builder, Business e Scale aumentam o limite e o uso justo mensal e desbloqueiam profundidade de membro (LiqMap em sete períodos, séries de 5 minutos, o catálogo x402 incluído no uso justo mensal). Defina-a como BYKARANTELI_API_KEY. Os dados cobrem perpétuos USDT-M da Binance; arbitragem de funding, liquidações, profundidade do order book, opções, posicionamento e fundos de seguro adicionam as outras exchanges que cada painel lista em bykaranteli.com/coverage.

Endpoint hospedado (sem instalação)

Cole https://mcp.bykaranteli.com como um conector personalizado em qualquer assistente compatível com MCP. As mesmas ferramentas, nada para instalar. Toda chamada de ferramenta precisa da sua chave de conta (gratuita em https://bykaranteli.com/dashboard/api); conectar e listar as ferramentas funciona sem uma. A chave viaja de três maneiras:

• o cabeçalho de requisição x-api-key: bk_... (conectores personalizados do claude.ai, Cursor, Claude Code);
• o cabeçalho de requisição Authorization: Bearer bk_...;
• o endereço https://mcp.bykaranteli.com/?key=bk_... para clientes que não podem enviar cabeçalhos (ChatGPT). Trate esse endereço como uma senha e revogue a chave se ela vazar.

Ou entre com OAuth 2.1 onde o cliente oferecer (conectores personalizados do claude.ai: Autenticação, Entrar; conectores do ChatGPT: OAuth): o cliente se registra (RFC 7591, PKCE S256), você aprova uma vez em bykaranteli.com e ele roda com uma chave da sua própria conta, que a página Data e API lista em aplicativos conectados. Descoberta: https://mcp.bykaranteli.com/.well-known/oauth-protected-resource.

Uma conta gratuita cobre a API e o MCP hospedado em um único contador mensal; Builder e acima trazem limites maiores e profundidade de membro.

Guia passo a passo para iniciantes: https://bykaranteli.com/guide/connect

Início rápido

Claude Code

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

Claude Desktop

Adicione em claude_desktop_config.json:

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

Cursor / outros clientes MCP

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

Requer Node.js 18 ou mais recente.

Ferramentas

Ferramenta	O que ela responde
get_market_indices	"Qual é o índice Fear & Greed hoje?", "Qual é a dominância do BTC agora?"
get_funding_heatmap	"Quais são as taxas de funding agora?", "Qual é o funding da SOL?"
get_funding_arbitrage	"Há alguma oportunidade de arbitragem de funding?", "Melhor exchange para comprar/vender BTC a descoberto para carry?"
get_pressure_scores	"Quais moedas estão sobre-alavancadas / lotadas agora?"
get_top_movers	"Maiores picos de OI hoje?", "Funding mais extremo agora?"
get_liquidations	"Quanto foi liquidado hoje?", "Longs ou shorts foram liquidados esta semana?"
get_liquidation_leaderboard	"Qual foi a maior liquidação hoje?", "Quando as liquidações se concentram, horário da Ásia ou dos EUA?"
get_insurance_funds	"Qual é o tamanho do fundo de seguro da Binance?", "Algum fundo de seguro de exchange encolheu esta semana?"
get_tokenized_stocks	"Quanto de Tesla tokenizada existe onchain?", "Qual ação tokenizada negocia mais longe da ação real?", "Qual preço avaliou o supply deste wrapper?" (price_source, totals.priced_by)
get_etf_flows	"Os ETFs de Bitcoin compraram ou venderam ontem?", "Entrada acumulada de ETH ETF?"
get_cot_positioning	"Os fundos de hedge estão comprados ou vendidos em Bitcoin?", "O que o relatório COT mostrou?"
get_options_snapshot	"Onde estão as paredes de opções de BTC?", "Qual é o DVOL / o nível de zero-gamma?"
get_coinbase_premium	"Investidores dos EUA estão comprando Bitcoin?", "O que a negociação de basis paga?"
get_flow_toxicity	"O fluxo tóxico de ordens está aumentando?", "Qual é o VPIN do BTC agora?"
get_options_flow	"O que os grandes players de opções estão comprando?", "Há block trades hoje?"
get_slippage	"Quanto slippage em uma ordem de mercado de $1M?", "Qual book é o mais fino?"
get_fomc_impact	"O que o BTC faz em dias de Fed?", "Quando é a próxima reunião do FOMC?"
get_liquidation_cascades	"O que causou essa queda?", "Quem foi liquidado esta semana?"
get_open_interest	"A alavancagem está entrando no mercado?", "Shorts estão aumentando na XRP?"
get_psi_charge	"Em que estado de liquidez o mercado está?", "O dinheiro parado está sendo usado?"
get_theme_indices	"Qual narrativa cripto está liderando: IA, RWA, DePIN, memes, L2s, DeFi?"
get_factor_board	"Quais indicadores estão em uma faixa incomum hoje, e o que aconteceu historicamente depois?"
get_venue_markets	"Open interest total de BTC entre exchanges?", "Qual é a participação de DEX no OI de perpétuos?", "O USDT está fora do peg em algum lugar?"
get_leverage_tiers	"Quanta alavancagem a Bybit permite na SOL?", "Qual exchange tem a maior alavancagem máxima para DOGE?", "Alguma exchange cortou alavancagem em uma moeda esta semana?"
get_withdrawal_status	"A KuCoin pausou saques de USDT?", "Rede mais barata para sacar USDT da Gate?", "Quais exchanges têm saques fechados agora?"
get_venue_profile	"O que você registra sobre a Bybit?", "Quantos contratos a OKX lista?", "A HTX está no ar, e o que aconteceu lá esta semana?"
get_settlements	"O que expira esta semana?", "Quando é o próximo trimestral de BTC na OKX?", "A que preço o futuro de setembro liquidou?"
get_borrow_rates	"Quanto custa emprestar USDT na Binance?", "Exchange mais barata para emprestar ETH?", "O empréstimo de stablecoin está disparando?"
get_fee_table	"Quais são as taxas de perpétuos da Bitget?", "Qual exchange tem a menor taxa taker?", "Alguma exchange mudou taxas esta semana?"
get_lead_lag	"A Coinbase ou a Binance se move primeiro?"
get_iv_surface	"Qual é a volatilidade implícita do BTC por vencimento?", "A proteção contra queda está cara (skew)?"
get_whale_tape	"As baleias estão comprando ou vendendo agora?"
get_correlations	"Qual é a correlação da SOL com o BTC em 30 dias?"
get_new_listings	"Quais perpétuos foram listados esta semana, e onde primeiro?"
get_macro_liquidity	"O que o balanço do Fed / RRP / supply de stablecoins está fazendo?"
get_network_health	"Hashrate do Bitcoin, dificuldade, taxas, mempool agora?"
get_tradfi_board	"Taxa de funding do perpétuo TSLA? Quais exchanges listam perpétuos NVDA? A sessão de ações está aberta?"
get_rsi_heatmap	"Quais moedas estão sobrevendidas no diário? RSI do BTC em 4h e 1s?"
get_hl_whales	"As baleias da Hyperliquid estão líquidas em BTC? O que as maiores contas acabaram de virar?"
get_positioning	"Razão long/short do BTC na Binance? Os melhores traders estão líquidos em ETH? CVD hoje?"
get_coverage	"Quais exchanges estão por trás dos seus totais de liquidação? Quão frescos são os dados?"
get_orderbook_depth	"Onde está a maior parede de compra de BTC? Quão profundo é o ETH dentro de 2% na Coinbase vs Binance?"
get_jupiter_perps	"Quanto OI longo vs curto há nos perpétuos SOL da Jupiter? Quem liderou a Jupiter esta semana? Qual é o APR do JLP?"
get_solana_perps	"Qual DEX de perpétuos Solana tem o maior open interest? Qual é o funding de BTC e volume 24h da Pacifica? Open interest da Phoenix SOL? GM Trade versus Jupiter?"
get_turkey_premium	"O que compradores de lira pagam pelo bitcoin acima do preço mundial? Qual é o Índice de Prêmio da Turquia e sua pontuação agora? Qual exchange turca é a mais cara? Qual é o USDT/TRY contra a taxa oficial?"
get_data_proof	"Posso verificar se um número da ByKaranteli não foi alterado depois? Mostre a prova onchain para o funding de BTC agora. Qual transação Solana selou a época mais recente?"
get_cycle_indicators	"O Pi Cycle cruzou? Mayer Multiple e Puell hoje?"
get_altseason	"É altseason?", "Qual é o índice de temporada de altcoins?"
get_metric_context	"O funding de hoje é extremo historicamente?", "Onde essa leitura se encaixa na sua distribuição?"
get_quantum_exposure	"Quanto Bitcoin é vulnerável a quantum?", "Qual é a exposição P2PK?"
get_liqmap	"Onde estão os clusters de liquidação de BTC?", "Onde longs alavancados seriam liquidados?"
get_market_profile	"Onde está o ponto de controle do BTC hoje?", "Qual foi a área de valor de ontem?", "Quais POCs nus ainda não foram testados?"
get_options_chain	"Como o open interest do BTC se moveu por strike hoje?", "Onde está o IV ATM do ETH hora a hora?", "Qual vencimento ganhou mais open interest em 24h?"
get_hl_positions	"Onde as baleias da Hyperliquid são liquidadas em BTC?", "Quanto notional rastreado está abaixo do preço?", "O modelo concorda com as posições rastreadas?"
get_venue_share	"Qual exchange teve mais liquidações esta semana?", "Como o open interest de perpétuos é dividido por exchange?"
get_tradfi_gaps	"O que o perpétuo TSLA fez no fim de semana?", "Qual foi o tamanho do gap de abertura de segunda na NVDA?", "Quão distantes estavam as exchanges durante a noite?"
get_series	"Open interest do BTC por hora na última semana?", "Funding de ETH na OKX desde 1º de setembro?", "Prêmio diário da Coinbase neste mês?" (lista de métricas, unidades e períodos mais finos: https://bykaranteli.com/api/series/metrics)

Todas as respostas de mercado são JSON e carregam um timestamp generatedAt, uma URL source para a página legível por humanos e um bloco provenance: source_page, api_path, o próprio generated_at da resposta, fetched_at, e quando a resposta os carrega, o venues por trás do número, coverage (full, sampled ou mixed), stale_venues e recorded_since, além da página proof (https://bykaranteli.com/proof). Um campo que a resposta não carrega é omitido, nunca preenchido. Símbolos aceitam tanto BTCUSDT quanto BTC puro.

Ferramentas de conta (alertas e watchlist)

Estas ferramentas leem e alteram sua própria conta ByKaranteli com a mesma chave: as receitas de alerta que notificam você no Telegram, e-mail, push ou webhook, e suas watchlists. Elas nunca negociam, movem fundos ou tocam outra conta.

Ferramenta	O que ela faz
parse_alert_text	Transforma "funding de BTC acima de 0,05%" ou "me avise quando ETH cair 5% em um dia" na receita exata, com uma confiança e o que o texto deixou em aberto. Baseada em regras; não salva nada, nunca inventa um limite.
list_alert_recipes	Lista suas receitas de alerta com suas condições, escopo, canais e quando cada uma disparou por último.
create_alert_recipe	Salva uma receita de alerta (escreve na sua conta).
delete_alert_recipe	Exclui uma de suas receitas de alerta por id (escreve na sua conta).
list_watchlists	Lista suas watchlists e os símbolos em cada uma.
add_watchlist_symbol	Adiciona um símbolo à sua lista padrão ou à lista que você nomear (escreve na sua conta).
remove_watchlist_symbol	Remove um símbolo de uma lista (escreve na sua conta).
list_tracked_addresses	Lista os endereços Hyperliquid que você segue, com suas últimas posições (lê sua conta).
add_tracked_address	Segue um endereço Hyperliquid para alertas de posição (escreve na sua conta; Terminal e acima).
remove_tracked_address	Para de seguir um endereço (escreve na sua conta).

• As ferramentas de escrita carregam readOnlyHint: false (e destructiveHint: true para as duas que removem algo), então clientes que perguntam antes de uma mudança perguntarão.
• Quantas receitas uma conta mantém segue seu plano; além disso, create_alert_recipe responde com o limite em vez de salvar.
• Cada chamada conta no plano da chave como qualquer outra requisição; escritas também são limitadas por taxa por chave, e cada escrita é registrada na conta com a chave que a fez.
• Receitas e mudanças de watchlist aparecem imediatamente em https://bykaranteli.com/dashboard/alerts e https://bykaranteli.com/dashboard/watchlist.

Configuração

Variável de ambiente	Padrão	Propósito
BYKARANTELI_API_KEY	nenhum	Chave de conta (bk_...) enviada como Authorization: Bearer. Gratuita em https://bykaranteli.com/dashboard/api; obrigatória para programas desde 2026-09-10
BYKARANTELI_BASE_URL	https://bykaranteli.com	Substitui o host da API (somente testes). A chave é enviada para qualquer host que este nomear, então aponte apenas para um servidor em que você confie.

Notas de dados

• O mecanismo de sinais foi descontinuado em setembro de 2026; este servidor publica apenas dados de mercado gravados, sem sinais de negociação ou alegações de desempenho.
• Dados de funding, OI e pressão são atualizados a cada 15 a 30 minutos; índices a cada 30 minutos.
• Nada aqui é aconselhamento financeiro. Consulte bykaranteli.com/risk-guide.

Desenvolvimento

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

Notas de versão por versão: CHANGELOG.md.

Licença

Servidor: MIT. Dados: uso pessoal e de pesquisa com atribuição "ByKaranteli (bykaranteli.com)"; uso comercial com o plano Business. Texto da licença: https://bykaranteli.com/data#license.

Planos e profundidade paga

Plano	Taxa	Mensal	Profundidade
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 uso justo	profundidade de membro, catálogo x402 incluído, cada chamada conta como 10 solicitações do uso justo mensal
Business	1.200 / min	3.000.000 uso justo	profundidade de membro, licença comercial, catálogo x402 incluído, cada chamada conta como 10 solicitações do uso justo mensal, volume mensal
Scale	3.000 / min	10.000.000 uso justo	profundidade de membro, redistribuição derivada, catálogo x402 incluído, cada chamada conta como 10 solicitações do uso justo mensal, bruto diário

Preços: https://bykaranteli.com/pricing

Uma chave Gratuita ou Terminal que ultrapasse o valor mensal recebe 429 até o mês reiniciar. Uma chave paga que ultrapasse o uso justo nunca é interrompida: ela responde na taxa Gratuita (30 por minuto) até o mês reiniciar, com x-quota-state: slow em cada resposta.

Tabela completa: https://bykaranteli.com/developers#tiers. Para histórico gravado e registros brutos além dos snapshots ao vivo, bykaranteli.com também expõe endpoints x402 de pagamento por chamada para agentes anônimos (USDC na Solana ou Base, precificado por chamada, sem conta): https://bykaranteli.com/developers#x402 · catálogo de máquinas: https://bykaranteli.com/api/x402. Chaves Builder, Business e Scale chamam essas rotas sem pagamento; cada chamada conta como 10 solicitações do uso justo mensal.