Documentation

Obtenez un verdict en moins d'une minute.

Tout ici fonctionne sans inscription — vos 250 premiers scans chaque mois sont gratuits, sans clé API. Choisissez votre voie ci-dessous.

Pour tous · sans code

Vérifiez un token depuis votre navigateur

Pas besoin d'être développeur pour utiliser Cabal-Hunter. La bubble map est gratuite et vous montre le graphe des wallets visuellement.

  1. Copiez le mint address du token — la longue chaîne de DexScreener, GMGN, pump.fun ou votre wallet (ça ressemble à Ad3w…pump).
  2. Ouvrez api.cabal-hunter.com/map et collez-le dans la barre de recherche.
  3. Lisez la map. Chaque bubble est une wallet (taille = détention). Les lignes sont des liens de funding — les bubbles connectées ont été financées par la même source. Les clusters rouges sont la cabal. Cliquez sur n'importe quelle bubble pour la vérifier sur Solscan.
Règle générale : un token sain ressemble à des bubbles dispersées et non connectées. Un rug en attente ressemble à une toile d'araignée — beaucoup de holders câblés à une seule source de funding, souvent créés dans le même bloc.
Pour les bot builders

API REST

Une requête GET, n'importe quel langage. Pas d'auth pour vos 250/mois gratuits — le compteur est par IP.

cURL — essayez tout de suite

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 réponse utiles

HeaderSignification
X-Free-Queries-RemainingScans gratuits restants ce mois pour votre IP — surveillez-le dans votre bot et rechargez avant qu'il n'atteigne zéro.
X-Cabal-RecommendationAVOID / CAUTION / LOW SIGNAL — conditionnez là-dessus sans parser le body.
X-Cabal-ScoreLe score de 0–100.
X-Key-Credits-RemainingSolde restant sur votre clé prépayée (en envoyant X-API-Key).
Aussi gratuit : GET /api/cex-funding?mint= (quels exchanges ont financé les holders), GET /api/trade-analysis?mint= (PnL par cohorte + score de wash-trade) et POST /api/watch (push webhook dès qu'un dump coordonné démarre sur un token que vous détenez). Spec lisible par machine : openapi.json.
Pour les agent developers

MCP — Claude, Cursor, VS Code

Cabal-Hunter est un serveur MCP hébergé sur https://api.cabal-hunter.com/mcp exposant un outil : check_cabal_risk(mintAddress). Votre agent l'appelle avant chaque swap — automatiquement.

Installations en un clic

⚡ Installer dans VS Code ⚡ Installer dans 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"]
    }
  }
}

Ensuite, demandez simplement

"Check the cabal risk on Ad3wM19jfM6DGbGaoswz3orJ5WHXWEjBGKpRZ2ggpump before I buy."
Astuce system-prompt pour agents de trading : ajoutez "Appelle check_cabal_risk avant tout achat Solana. N'achète pas si recommendation est AVOID ou cabal_score ≥ 65." — cette ligne rend le gate automatique.
Pour les ElizaOS builders

Plugin ElizaOS

Un plugin npm publié ajoute l'action CHECK_CABAL_RISK à n'importe quel agent Eliza.

npm install elizaos-plugin-cabal-hunter

Enregistrez-le dans votre character

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

export const character = {
  ...
  plugins: [cabalHunterPlugin],
}
Pour votre dashboard

Widget badge en direct

Deux lignes de HTML affichent une carte de verdict en direct — cercle de score, signaux, lien vers la map en direct — pour n'importe quel token, sur n'importe quel site. Fonctionne en HTML pur, React, partout.

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

Options

AttributCe que ça fait
data-mintRequis. Le mint Solana à scanner et afficher.
data-refresh="120"Re-scanne toutes les N secondes (min 60) — verdicts en direct pendant que vous tradez.
data-api-key="ch_live_…"Utilisez votre clé prépayée une fois le tier gratuit dépassé.
Référence

Champs de réponse

Les champs que votre code utilisera vraiment. Schéma complet : openapi.json.

ChampSignification
cabal_score0–100. ≥65 = risque ÉLEVÉ, ≥35 = CAUTION, en dessous = signal faible.
recommendationAVOID / CAUTION / LOW SIGNAL — le seul champ sur lequel conditionner un achat.
riskHIGH / MEDIUM / CLEAN.
verdictRésumé en langage clair de tout ce qui a été trouvé — lisible par un humain, à logger.
time_synctrue = les holders ont acheté dans le même bloc exact (lancement bundled).
coordinated_exittrue = plusieurs holders qui dumpent dans le même bloc, en ce moment.
top_holder_pctPart du plus gros holder individuel non-LP sur le supply.
deployer.verdictFIRST_LAUNCH / NORMAL / POOR_TRACK_RECORD / SERIAL_RUGGER — plus leur historique de lancements.
coordinated_clusters[]Chaque cluster : type (funding / time_sync / coordinated_exit), % combiné du supply, et evidence_txs[] — les transactions de preuve.
filtered_clusters[]Clusters que nous excluons comme bruit CEX (ex. funding Binance partagé) — montrés pour que vous vérifiiez qu'on ne cache rien.
honeypot_riskSignaux honeypot natifs Solana : freeze authority active, pièges Token-2022.
liquidity_usd · market_capEn direct depuis DexScreener au moment du scan.
free_queries_remainingScans gratuits restants ce mois pour votre IP.
Tarifs et clés

Gratuit pour la plupart. 9 $/mois si votre bot ne s'arrête jamais.

Prix à coût — chaque scan lance des appels RPC Helius en direct. Rien n'est jamais débité automatiquement : les paiements crypto sont push-only, vous gardez toujours le contrôle.

Tier gratuit — la plupart y restent

250 scans / mois par IP. Sans inscription, sans clé, sans carte. Le champ free_queries_remaining et le header X-Free-Queries-Remaining affichent votre solde à chaque réponse, et un champ warning apparaît à 20 restants.

Au-delà du gratuit — deux options

9 $/mois Illimité (usage équitable, 50k/mois) pour bots 24/7 — ou à l'usage à 0,001 $/scan, tout montant à partir de 1 $. Dans les deux cas, un paiement USDC depuis n'importe quelle wallet Solana.

Obtenir une clé (60 secondes, sans compte)

  1. Envoyez de l'USDC sur Solana à la wallet affichée sur /pricing — 9 $ pour l'Illimité, ou tout montant ≥ 1 $ pour des crédits à l'usage.
  2. Validez la transaction : collez la signature de la tx sur /pricing, ou depuis le code : POST /api/buy-key {"tx_signature": "…"}
  3. Utilisez la clé renvoyée comme header à chaque scan : X-API-Key: ch_live_… — vérifiez le solde à tout moment sur GET /api/key-balance.
Pour les agents autonomes : le flux x402 pay-per-call est aussi supporté — le body de la réponse 402 contient des instructions de paiement complètes et lisibles par machine (destinataire, montant, memo), donc un agent peut payer et réessayer sans humain.
Dépannage

Réponses rapides

J'obtiens un HTTP 402

Votre IP a utilisé ses 250 scans gratuits ce mois. Le body de la réponse liste les deux façons de continuer (9 $ Illimité ou 0,001 $/scan). Les compteurs se réinitialisent le 1er.

Le scan prend quelques secondes

Les tokens à froid nécessitent un trace on-chain en direct (1–5s). Les déjà indexés reviennent en <100ms. Passez pairCreatedAt (timestamp en ms de DexScreener) pour accélérer les scans à froid.

Le score dit CLEAN mais le token a rug

CLEAN signifie pas de cabal coordonnée — ça ne peut pas prédire un dev solo qui retire la liquidité avec un graphe de wallets propre. Combinez avec top_holder_pct, deployer.verdict et la liquidité pour l'image complète — et regardez la démo en direct pour voir sa performance sur notre propre bot.

Autre chose ?

Utilisez la boîte de feedback sur la homepage — ça nous arrive directement — ou pinguez @CabalhunterAPI.