Documentación

Obtén un veredicto en menos de un minuto.

Todo aquí funciona sin registro — tus primeros 250 escaneos cada mes son gratis, sin clave API. Elige tu camino abajo.

Para todos · sin código

Comprueba un token desde tu navegador

No necesitas ser desarrollador para usar Cabal-Hunter. El bubble map es gratis y te muestra el grafo de wallets visualmente.

  1. Copia el mint address del token — la cadena larga de DexScreener, GMGN, pump.fun o tu wallet (se ve como Ad3w…pump).
  2. Abre api.cabal-hunter.com/map y pégalo en la caja de búsqueda.
  3. Lee el mapa. Cada bubble es una wallet (tamaño = tenencia). Las líneas son enlaces de funding — los bubbles conectados fueron financiados desde la misma fuente. Los clusters rojos son la cabal. Haz clic en cualquier bubble para verificarlo en Solscan.
Regla general: un token sano se ve como bubbles dispersos y sin conexión. Un rug en espera se ve como una telaraña — muchos holders cableados a una sola fuente de funding, a menudo creados en el mismo bloque.
Para bot builders

API REST

Un solo GET, cualquier lenguaje. Sin auth para tus 250/mes gratis — el contador es por IP.

cURL — pruébalo ahora mismo

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 respuesta útiles

HeaderSignificado
X-Free-Queries-RemainingEscaneos gratis que quedan este mes para tu IP — vigílalo en tu bot y recarga antes de que llegue a cero.
X-Cabal-RecommendationAVOID / CAUTION / LOW SIGNAL — condiciona sobre esto sin parsear el body.
X-Cabal-ScoreEl score de 0–100.
X-Key-Credits-RemainingSaldo restante en tu clave prepagada (al enviar X-API-Key).
También gratis: GET /api/cex-funding?mint= (qué exchanges financiaron a los holders), GET /api/trade-analysis?mint= (PnL por cohorte + score de wash-trade) y POST /api/watch (push por webhook en cuanto empieza un dump coordinado en un token que tienes). Spec legible por máquina: openapi.json.
Para agent developers

MCP — Claude, Cursor, VS Code

Cabal-Hunter es un servidor MCP alojado en https://api.cabal-hunter.com/mcp que expone una herramienta: check_cabal_risk(mintAddress). Tu agente la llama antes de cualquier swap — automáticamente.

Instalaciones en un clic

⚡ Instalar en VS Code ⚡ Instalar en 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"]
    }
  }
}

Luego solo pregunta

"Check the cabal risk on Ad3wM19jfM6DGbGaoswz3orJ5WHXWEjBGKpRZ2ggpump before I buy."
Tip de system-prompt para agentes de trading: añade "Llama a check_cabal_risk antes de cualquier compra en Solana. No compres si recommendation es AVOID o cabal_score ≥ 65." — esa línea hace el gate automático.
Para ElizaOS builders

Plugin de ElizaOS

Un plugin de npm publicado añade la acción CHECK_CABAL_RISK a cualquier agente Eliza.

npm install elizaos-plugin-cabal-hunter

Regístralo en tu character

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

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

Widget de badge en vivo

Dos líneas de HTML renderizan una tarjeta de veredicto en vivo — círculo de score, señales, enlace al mapa en vivo — para cualquier token, en cualquier sitio. Funciona en HTML plano, React, donde sea.

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

Opciones

AtributoQué hace
data-mintObligatorio. El mint de Solana a escanear y mostrar.
data-refresh="120"Re-escanea cada N segundos (mín 60) — veredictos en vivo mientras operas.
data-api-key="ch_live_…"Usa tu clave prepagada una vez que pasas el tier gratis.
Referencia

Campos de la respuesta

Los campos que tu código realmente usará. Schema completo: openapi.json.

CampoSignificado
cabal_score0–100. ≥65 = riesgo ALTO, ≥35 = CAUTION, por debajo = señal baja.
recommendationAVOID / CAUTION / LOW SIGNAL — el único campo sobre el que condicionar una compra.
riskHIGH / MEDIUM / CLEAN.
verdictResumen en lenguaje claro de todo lo encontrado — legible por humanos, guárdalo en logs.
time_synctrue = los holders compraron en el mismo bloque exacto (lanzamiento bundled).
coordinated_exittrue = varios holders dumpeando en el mismo bloque, ahora mismo.
top_holder_pctParticipación del mayor holder individual no-LP sobre el supply.
deployer.verdictFIRST_LAUNCH / NORMAL / POOR_TRACK_RECORD / SERIAL_RUGGER — más su historial de lanzamientos.
coordinated_clusters[]Cada cluster: type (funding / time_sync / coordinated_exit), % combinado del supply, y evidence_txs[] — las transacciones de prueba.
filtered_clusters[]Clusters que excluimos como ruido CEX (p. ej. funding compartido de Binance) — mostrados para que verifiques que no ocultamos nada.
honeypot_riskSeñales de honeypot nativas de Solana: freeze authority activa, trampas de Token-2022.
liquidity_usd · market_capEn vivo desde DexScreener al momento del escaneo.
free_queries_remainingEscaneos gratis que quedan este mes para tu IP.
Precios y claves

Gratis para la mayoría. $9/mes si tu bot no para.

Precio a coste — cada escaneo ejecuta llamadas RPC en vivo a Helius. Nunca se cobra automáticamente: los pagos cripto son push-only, así que siempre mantienes el control.

Tier gratis — la mayoría se queda aquí

250 escaneos / mes por IP. Sin registro, sin clave, sin tarjeta. El campo free_queries_remaining y el header X-Free-Queries-Remaining muestran tu saldo en cada respuesta, y aparece un campo warning cuando quedan 20.

Más allá del gratis — dos opciones

$9/mes Ilimitado (uso justo, 50k/mes) para bots 24/7 — o pago por uso a $0.001/escaneo, cualquier monto desde $1. En ambos casos es un pago en USDC desde cualquier wallet de Solana.

Obtener una clave (60 segundos, sin cuenta)

  1. Envía USDC en Solana a la wallet mostrada en /pricing — $9 para Ilimitado, o cualquier monto ≥ $1 para créditos de pago por uso.
  2. Canjea la transacción: pega la firma de la tx en /pricing, o desde código: POST /api/buy-key {"tx_signature": "…"}
  3. Usa la clave devuelta como header en cada escaneo: X-API-Key: ch_live_… — consulta el saldo cuando quieras en GET /api/key-balance.
Para agentes autónomos: también se soporta el flujo x402 pay-per-call — el body de la respuesta 402 contiene instrucciones de pago completas legibles por máquina (destinatario, monto, memo), así que un agente puede pagar y reintentar sin un humano.
Solución de problemas

Respuestas rápidas

Me sale HTTP 402

Tu IP usó sus 250 escaneos gratis este mes. El body de la respuesta lista las dos formas de seguir ($9 Ilimitado o $0.001/escaneo). Los contadores se reinician el día 1.

El escaneo tarda unos segundos

Los tokens en frío necesitan un rastreo on-chain en vivo (1–5s). Los ya indexados vuelven en <100ms. Pasa pairCreatedAt (timestamp en ms de DexScreener) para acelerar los escaneos en frío.

El score dice CLEAN pero el token hizo rug

CLEAN significa sin cabal coordinada — no puede predecir a un dev solitario retirando liquidez con un grafo de wallets limpio. Combínalo con top_holder_pct, deployer.verdict y liquidez para la imagen completa — y mira la demo en vivo para ver cómo rinde en nuestro propio bot.

¿Otra cosa?

Usa la caja de feedback en la homepage — nos llega directo — o escribe a @CabalhunterAPI.