Documentação

Tenha um veredito em menos de um minuto.

Tudo aqui funciona sem cadastro — seus primeiros 250 scans por mês são grátis, sem chave API. Escolha seu caminho abaixo.

Para todos · sem código

Cheque um token pelo seu navegador

Você não precisa ser desenvolvedor para usar o Cabal-Hunter. O bubble map é grátis e mostra o grafo de wallets visualmente.

  1. Copie o mint address do token — a string longa do DexScreener, GMGN, pump.fun ou sua wallet (parece Ad3w…pump).
  2. Abra api.cabal-hunter.com/map e cole na caixa de busca.
  3. Leia o mapa. Cada bubble é uma wallet (tamanho = posição). Linhas são links de funding — bubbles conectados foram financiados pela mesma fonte. Clusters vermelhos são a cabal. Clique em qualquer bubble para verificar no Solscan.
Regra prática: um token saudável parece bubbles espalhados e sem conexão. Um rug à espera parece uma teia de aranha — muitos holders ligados a uma única fonte de funding, geralmente criados no mesmo bloco.
Para bot builders

API REST

Um GET, qualquer linguagem. Sem auth para seus 250/mês grátis — o contador é por IP.

cURL — teste agora

curl "https://api.cabal-hunter.com/api/scan-cabal?mintAddress=<MINT>"

Python

import requests

r = requests.get(
    "https://api.cabal-hunter.com/api/scan-cabal",
    params={"mintAddress": mint},
    timeout=30,
).json()

if r["recommendation"] == "AVOID" or r["cabal_score"] >= 65:
    abort_buy()

JavaScript / TypeScript

const r = await (await fetch(
  `https://api.cabal-hunter.com/api/scan-cabal?mintAddress=${mint}`
)).json()

if (r.recommendation === "AVOID" || r.cabal_score >= 65) {
  abortBuy()
}

Headers de resposta úteis

HeaderSignificado
X-Free-Queries-RemainingScans grátis restantes este mês para seu IP — monitore no seu bot e recarregue antes de zerar.
X-Cabal-RecommendationAVOID / CAUTION / LOW SIGNAL — condicione nisso sem parsear o body.
X-Cabal-ScoreO score de 0–100.
X-Key-Credits-RemainingSaldo restante na sua chave pré-paga (ao enviar X-API-Key).
Também grátis: GET /api/cex-funding?mint= (quais exchanges financiaram os holders), GET /api/trade-analysis?mint= (PnL por coorte + score de wash-trade) e POST /api/watch (push por webhook no instante em que um dump coordenado começa num token que você tem). Spec legível por máquina: openapi.json.
Para agent developers

MCP — Claude, Cursor, VS Code

O Cabal-Hunter é um servidor MCP hospedado em https://api.cabal-hunter.com/mcp expondo uma ferramenta: check_cabal_risk(mintAddress). Seu agente a chama antes de qualquer swap — automaticamente.

Instalações em um clique

⚡ Instalar no VS Code ⚡ Instalar no Cursor

Claude Code (CLI)

claude mcp add --transport http cabal-hunter https://api.cabal-hunter.com/mcp

Claude Desktop claude_desktop_config.json

{
  "mcpServers": {
    "cabal-hunter": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.cabal-hunter.com/mcp"]
    }
  }
}

Depois é só pedir

"Check the cabal risk on Ad3wM19jfM6DGbGaoswz3orJ5WHXWEjBGKpRZ2ggpump before I buy."
Dica de system-prompt para agentes de trading: adicione "Chame check_cabal_risk antes de qualquer compra na Solana. Não compre se recommendation for AVOID ou cabal_score ≥ 65." — essa linha torna o gate automático.
Para ElizaOS builders

Plugin do ElizaOS

Um plugin npm publicado adiciona a ação CHECK_CABAL_RISK a qualquer agente Eliza.

npm install elizaos-plugin-cabal-hunter

Registre no seu character

import { cabalHunterPlugin } from "elizaos-plugin-cabal-hunter"

export const character = {
  ...
  plugins: [cabalHunterPlugin],
}
Para seu dashboard

Widget de badge ao vivo

Duas linhas de HTML renderizam um card de veredito ao vivo — círculo de score, sinais, link do mapa ao vivo — para qualquer token, em qualquer site. Funciona em HTML puro, React, em qualquer lugar.

<div class="cabal-hunter-badge" data-mint="YOUR_TOKEN_MINT"></div>
<script src="https://api.cabal-hunter.com/widget.js" defer></script>

Opções

AtributoO que faz
data-mintObrigatório. O mint da Solana a escanear e exibir.
data-refresh="120"Re-escaneia a cada N segundos (mín 60) — veredictos ao vivo enquanto você opera.
data-api-key="ch_live_…"Use sua chave pré-paga depois de passar do tier grátis.
Referência

Campos da resposta

Os campos que seu código vai realmente usar. Schema completo: openapi.json.

CampoSignificado
cabal_score0–100. ≥65 = risco ALTO, ≥35 = CAUTION, abaixo = sinal baixo.
recommendationAVOID / CAUTION / LOW SIGNAL — o único campo para condicionar uma compra.
riskHIGH / MEDIUM / CLEAN.
verdictResumo em linguagem clara de tudo o que foi encontrado — legível por humanos, salve no log.
time_synctrue = holders compraram no mesmo bloco exato (lançamento bundled).
coordinated_exittrue = vários holders dumpando no mesmo bloco, agora.
top_holder_pctFatia do maior holder individual não-LP sobre o supply.
deployer.verdictFIRST_LAUNCH / NORMAL / POOR_TRACK_RECORD / SERIAL_RUGGER — mais o histórico de lançamentos.
coordinated_clusters[]Cada cluster: type (funding / time_sync / coordinated_exit), % combinado do supply, e evidence_txs[] — as transações de prova.
filtered_clusters[]Clusters que excluímos como ruído de CEX (ex.: funding compartilhado da Binance) — mostrados para você verificar que não escondemos nada.
honeypot_riskSinais de honeypot nativos da Solana: freeze authority ativa, armadilhas de Token-2022.
liquidity_usd · market_capAo vivo do DexScreener no momento do scan.
free_queries_remainingScans grátis restantes este mês para seu IP.
Preços e chaves

Grátis para a maioria. $9/mês se seu bot nunca para.

Preço a custo — cada scan roda chamadas RPC ao vivo no Helius. Nada é cobrado automaticamente: pagamentos cripto são push-only, então você sempre mantém o controle.

Tier grátis — a maioria fica aqui

250 scans / mês por IP. Sem cadastro, sem chave, sem cartão. O campo free_queries_remaining e o header X-Free-Queries-Remaining mostram seu saldo em cada resposta, e um campo warning aparece quando restam 20.

Além do grátis — duas opções

$9/mês Ilimitado (uso justo, 50k/mês) para bots 24/7 — ou pague pelo uso a $0.001/scan, qualquer valor a partir de $1. De qualquer forma é um pagamento em USDC de qualquer wallet Solana.

Pegar uma chave (60 segundos, sem conta)

  1. Envie USDC na Solana para a wallet mostrada em /pricing — $9 para Ilimitado, ou qualquer valor ≥ $1 para créditos de uso.
  2. Resgate a transação: cole a assinatura da tx em /pricing, ou via código: POST /api/buy-key {"tx_signature": "…"}
  3. Use a chave retornada como header em cada scan: X-API-Key: ch_live_… — veja o saldo quando quiser em GET /api/key-balance.
Para agentes autônomos: o fluxo x402 pay-per-call também é suportado — o body da resposta 402 contém instruções de pagamento completas e legíveis por máquina (destinatário, valor, memo), então um agente pode pagar e repetir sem um humano.
Solução de problemas

Respostas rápidas

Recebo HTTP 402

Seu IP usou os 250 scans grátis deste mês. O body da resposta lista as duas formas de continuar ($9 Ilimitado ou $0.001/scan). Os contadores reiniciam no dia 1.

O scan leva alguns segundos

Tokens a frio precisam de um rastreio on-chain ao vivo (1–5s). Os já indexados voltam em <100ms. Passe pairCreatedAt (timestamp em ms do DexScreener) para acelerar scans a frio.

O score diz CLEAN mas o token deu rug

CLEAN significa sem cabal coordenada — não dá para prever um dev solitário puxando liquidez com um grafo de wallets limpo. Combine com top_holder_pct, deployer.verdict e liquidez para o quadro completo — e veja a demo ao vivo de como rende no nosso próprio bot.

Outra coisa?

Use a caixa de feedback na homepage — vem direto pra gente — ou chame @CabalhunterAPI.