Documentatie

Krijg een oordeel in minder dan een minuut.

Alles hier werkt zonder registratie — je eerste 250 scans per maand zijn gratis, geen API-key nodig. Kies hieronder je pad.

Haal een gratis API-sleutel

250 scans per maand, voor altijd gratis. Geen kaart, geen kosten.

Je e-mail wordt alleen gebruikt voor je sleutel en servicemeldingen. Verder niets.

Why we ask. 98.5% of the addresses that scan here use exactly one scan and never come back — and 1,656 of them share a single identical browser fingerprint, one request each. Limits counted per address cannot see a pattern like that, because every request looks like a different person. One email keeps the free tier genuinely free for people actually using the tool.

Voor iedereen · geen code

Check een token vanuit je browser

Je hoeft geen developer te zijn om Cabal-Hunter te gebruiken. De diamond map is gratis en toont je de wallet-graph visueel.

  1. Kopieer het mint address van de token — de lange string van DexScreener, GMGN, pump.fun of je wallet (ziet eruit als Ad3w…pump).
  2. Open cabal-hunter.com/map en plak 'm in de zoekbalk.
  3. Lees de map. Elke diamond is een wallet (grootte = bezit). Lijnen zijn funding-links — verbonden diamonds zijn vanuit dezelfde bron gefinancierd. Rode clusters zijn de cabal. Klik op een diamond om 'm op Solscan te verifiëren.
Vuistregel: een gezonde token ziet eruit als verspreide, onverbonden diamonds. Een rug-in-de-maak ziet eruit als een spinnenweb — veel holders bedraad aan één funding-bron, vaak in hetzelfde blok aangemaakt.
Voor bot-builders

REST-API

Eén GET-request, elke taal. Geen auth voor je 5 gratis scans per maand; met een gratis key worden het er 250.

cURL — probeer het nu

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()
}

여러 토큰을 한 번에 — /api/scan-batch

피드를 선별 중인가요? 반복 호출 대신 한 요청에 최대 25개 민트를 보낼 수 있습니다. 보낸 순서대로 민트당 한 행이 반환되며, 분석할 수 없는 민트는 배치를 실패시키지 않고 오류 행으로 돌아옵니다. 민트당 1스캔이며 키가 필요합니다(무료 키로 충분).

curl -X POST "https://api.cabal-hunter.com/api/scan-batch" \
  -H "X-API-Key: <YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"mints":["<MINT>","<MINT>"]}'

텔레그램 — 설치 불필요

@TheCabalHunter_Bot 에 민트를 붙여넣으면 동일한 판정, 배포자 기록, 홀더 분석을 채팅으로 받습니다. /watch <mint> 는 조직적 매도나 유동성 유출이 시작되는 즉시 알려줍니다. t.me/TheCabalHunter_Bot

Handige response-headers

HeaderBetekenis
X-Free-Queries-RemainingGratis scans over deze maand voor je IP — houd dit in je bot in de gaten en vul aan voordat het nul raakt.
X-Cabal-Risk-LevelHIGH / ELEVATED / LOW_SIGNAL — lees het zonder de body te parsen.
X-Cabal-RecommendationSAFE / REVIEW / AVOID — verouderd. Gebruik X-Cabal-Risk-Level.
X-Cabal-ScoreDe 0–100 score.
X-Key-Credits-RemainingResterend saldo op je prepaid key (bij het sturen van X-API-Key).
Ook gratis: GET /api/cex-funding?mint= (welke exchanges de holders financierden), GET /api/trade-analysis?mint= (cohort-PnL + wash-trade-score) en POST /api/watch (webhook-push op het moment dat een gecoördineerde dump start op een token die je hebt). Machine-leesbare spec: openapi.json.
Voor agent-developers

MCP — Claude, Cursor, VS Code

Cabal-Hunter is een gehoste MCP-server op https://api.cabal-hunter.com/mcp die één tool aanbiedt: check_cabal_risk(mintAddress). Je agent roept 'm aan vóór elke swap — automatisch.

Installaties met één klik

⚡ Installeren in VS Code ⚡ Installeren in 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"]
    }
  }
}

Vraag daarna gewoon

"Check the cabal risk on Ad3wM19jfM6DGbGaoswz3orJ5WHXWEjBGKpRZ2ggpump before I buy."
System-prompt-tip voor trading-agents: voeg toe "Roep check_cabal_risk aan vóór elke Solana-koop. Koop niet als risk_level HIGH is of cabal_score ≥ 65." — die ene regel maakt de gate automatisch.
Voor ElizaOS-builders

ElizaOS-plugin

Een gepubliceerde npm-plugin voegt de CHECK_CABAL_RISK actie toe aan elke Eliza-agent.

npm install elizaos-plugin-cabal-hunter

Registreer het in je character

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

export const character = {
  ...
  plugins: [cabalHunterPlugin],
}
Voor je dashboard

Live badge-widget

Twee regels HTML renderen een live oordeel-kaart — score-cirkel, flags, live-map-link — voor elke token, op elke site. Werkt in pure HTML, React, overal.

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

Opties

AttribuutWat het doet
data-mintVerplicht. De Solana-mint om te scannen en tonen.
data-refresh="120"Re-scan elke N seconden (min 60) — live oordelen terwijl je handelt.
data-api-key="ch_live_…"Gebruik je prepaid key zodra je voorbij het gratis tier bent.
Referentie

Response-velden

De velden die je code echt gaat gebruiken. Volledig schema: openapi.json.

VeldBetekenis
cabal_score0–100. ≥65 = HOOG risico, ≥35 = CAUTION, daaronder = zwak signaal.
risk_levelHIGH / ELEVATED / LOW_SIGNAL — wat wij hebben waargenomen. LOW_SIGNAL betekent dat onze checks niet afgingen; het is geen veiligheidsbeoordeling.
recommendationSAFE / REVIEW / AVOID — verouderd, blijft zodat bestaande bots werken. Gebruik liever risk_level.
riskHIGH / MEDIUM / CLEAN.
verdictKlare-taal-samenvatting van alles wat gevonden is — leesbaar voor mensen, log het.
time_synctrue = holders kochten in exact hetzelfde blok (gebundelde launch).
coordinated_exittrue = meerdere holders die in hetzelfde blok dumpen, nu.
top_holder_pctAandeel van de grootste losse niet-LP-holder in de supply.
deployer.verdictFIRST_LAUNCH / NORMAL / POOR_TRACK_RECORD / SERIAL_LAUNCHER — plus hun launch-geschiedenis.
coordinated_clusters[]Elke cluster: type (funding / time_sync / coordinated_exit), gecombineerd % van de supply, en evidence_txs[] — de bewijs-transacties.
filtered_clusters[]Clusters die we uitsloten als CEX-ruis (bv. gedeelde Binance-funding) — getoond zodat je kunt verifiëren dat we niets verbergen.
honeypot_riskSolana-native honeypot-signalen: actieve freeze authority, Token-2022-vallen.
liquidity_usd · market_capLive van DexScreener op scan-moment.
free_queries_remainingGratis scans over deze maand voor je IP.
Prijzen & keys

Gratis voor de meesten. $9/mnd als je bot nooit stopt.

Een token dat in de afgelopen 8 uur is getraced, wordt uit die trace beantwoord (computed_at laat zien wanneer); elke andere token draait een live on-chain trace. Er wordt nooit automatisch afgeschreven: crypto-betalingen zijn push-only, dus jij houdt altijd de controle.

Gratis tier — de meesten blijven hier

5 scans per maand zonder enige registratie, daarna 250 met een gratis key. Eén e-mail, geen kaart. Het veld free_queries_remaining en de header X-Free-Queries-Remaining tonen je saldo bij elke response, en een warning-veld verschijnt bij 20 over.

Voorbij gratis — twee opties

$9/maand Onbeperkt (fair use, 50k/mnd) voor 24/7-bots — of betalen per gebruik voor $0.001/scan, elk bedrag vanaf $1. Hoe dan ook is het één USDC-betaling vanuit elke Solana-wallet.

Een key krijgen (60 seconden, geen account)

  1. Stuur USDC op Solana naar de wallet getoond op /pricing — $9 voor Onbeperkt, of elk bedrag ≥ $1 voor gebruikscredits.
  2. Verzilver de transactie: plak de tx-signature op /pricing, of via code: POST /api/buy-key {"tx_signature": "…"}
  3. Gebruik de teruggegeven key als header bij elke scan: X-API-Key: ch_live_… — check het saldo wanneer je wilt op GET /api/key-balance.
Voor autonome agents: de x402 pay-per-call-flow wordt ook ondersteund — de body van de 402-response bevat volledige machine-leesbare betaalinstructies (ontvanger, bedrag, memo), zodat een agent kan betalen en opnieuw proberen zonder mens.
LIVE MONITORING

Watch a token you already hold

A scan answers what is behind a token right now — a question you ask once. A watch answers whether it is still safe to hold, which is a question that never stops being worth asking. We poll the token continuously and POST your webhook the moment a coordinated dump or a liquidity drain begins.

Register a watch

Needs a key so that only you can see or remove your own watches. A free key is enough.

curl -X POST https://api.cabal-hunter.com/api/watch -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"mint":"<MINT>","webhook_url":"https://your-bot.example.com/hook"}'

Your webhook must resolve to a public address. Loopback, private ranges, link-local and cloud-metadata targets are refused — that field is a common way to attack the server receiving it, and we do not accept it on ours.

Manage them

GET /api/watch lists only your own watches, with used and limit so your client never has to guess its headroom. DELETE /api/watch removes one; omit webhook_url to remove every watch you hold on that mint.

Re-registering the same mint and URL is idempotent and does not consume another slot. If you reach your plan limit the API answers 429 and tells you the limit and how many you are using.

What arrives when it fires

Every claim comes with the transactions that prove it. evidence_txs are Solscan-verifiable signatures, so your bot can confirm the alert on-chain instead of trusting us — the same principle as the scanner.

{ "event": "dump_detected", "mint": "<MINT>", "reason": "price -34% since last check", "drop_pct": 34.2, "price_usd": 0.0000021, "previous_price_usd": 0.0000032, "liquidity_usd": 4200, "previous_liquidity_usd": 9100, "coordinated": true, "coordinated_detail": { "wallet_count": 7, "sold_pct": 41.2, "slot": "slot 298471123", "evidence_txs": ["...", "...", "..."] }, "verify": "https://cabal-hunter.com/map?mint=<MINT>", "action": "consider_immediate_exit" }
A watch reports what we observed on-chain. It is not a prediction, not financial advice and not a guarantee that you can still exit — liquidity may already be gone by the time anyone can act. Always do your own research.
BETAALDE ADD-ON

Je eigen privélijst van wallets

Houd een lijst bij van wallets die je belangrijk vindt: elke scan meldt dan ook welke daarvan echt in de token zitten, in het veld screen_list van het resultaat. $9 per maand bovenop elke sleutel, ook een gratis sleutel. Op elk moment opzegbaar.

Inschakelen

Geeft een checkout-link terug voor de sleutel die de aanroep deed. Er wordt niets nieuws aangemaakt — de add-on gaat aan op de sleutel die je al hebt.

curl -X POST https://api.cabal-hunter.com/api/screen-list/checkout -H "X-API-Key: YOUR_KEY"

Een wallet toevoegen

Het label is alleen van jou en wordt alleen aan jou getoond. Een lijst bevat tot 500 wallets; adressen worden gevalideerd, dus een gelijkende string wordt geweigerd met de reden in plaats van stil opgeslagen.

curl -X POST https://api.cabal-hunter.com/api/screen-list -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"wallet":"<WALLET>","label":"for my eyes only"}' curl https://api.cabal-hunter.com/api/screen-list -H "X-API-Key: YOUR_KEY" curl -X DELETE https://api.cabal-hunter.com/api/screen-list/<WALLET> -H "X-API-Key: YOUR_KEY"

Wat je terugkrijgt

Elke scan krijgt een screen_list-object: checked, matches en hits[] — per hit de wallet, jouw label, de rol (holder of cluster_funder) en het aandeel in de supply waar bekend.

"screen_list": { "checked": true, "matches": 1, "hits": [ { "wallet": "<WALLET>", "label": "for my eyes only", "role": "holder", "pct": 4.1 } ] }

checked: true met nul matches betekent dat de screening WEL liep en niets vond — dat is iets anders dan helemaal niet screenen. Het ontbreken van een match is nooit een schone lei voor een wallet die je niet op de lijst had.

Je lijst is privé aan jouw sleutel. We publiceren geen wallet-lijsten en beweren niets over wie een adres bezit — een hit is een on-chain waarneming, nooit een uitspraak over een persoon.
Probleemoplossing

Snelle antwoorden

Ik krijg HTTP 402

Je IP heeft z'n 250 gratis scans deze maand gebruikt. De response-body noemt beide manieren om door te gaan ($9 Onbeperkt of $0.001/scan). Tellers resetten op de 1e.

De scan duurt een paar seconden

Koude tokens hebben een live on-chain trace nodig (15–20s). Al geïndexeerde komen in <100ms terug. Geef pairCreatedAt mee (DexScreener ms-timestamp) om koude scans te versnellen.

Score zegt CLEAN maar de token rugde

CLEAN betekent geen gecoördineerde cabal — het kan geen solo-dev voorspellen die liquiditeit trekt met een schone wallet-graph. Combineer met top_holder_pct, deployer.verdict en liquiditeit voor het volledige plaatje — en bekijk de live demo voor hoe het presteert op onze eigen bot.

Iets anders?

Gebruik de feedback-box op de homepage — het komt direct bij ons — of ping @CabalhunterAPI.