{"openapi":"3.1.0","info":{"title":"Cabal-Hunter API","version":"1.1.0","description":"On-chain Solana token safety scanner for AI trading agents and bots. Given a Solana mint address it traces coordinated wallet funding, same-block Jito bundles, serial-launcher deployers and live coordinated dumps, and returns one Exit-Liquidity Risk verdict (recommendation + 0-100 cabal_score) BEFORE you buy. Call it before any Solana swap; abort the buy if recommendation is AVOID or cabal_score >= 65. 250 free scans/month per IP, no signup; then 0.001 USDC per scan via x402 (at-cost: covers the Helius RPC calls of the trace).","contact":{"name":"Cabal-Hunter","url":"https://api.cabal-hunter.com/","email":"paulf280@gmail.com"}},"servers":[{"url":"https://api.cabal-hunter.com"}],"paths":{"/api/scan-cabal":{"get":{"operationId":"scanCabalGet","summary":"Scan a Solana mint for cabal / rug / bundle risk (GET)","description":"Returns the full Exit-Liquidity Risk analysis for a Solana token. Use before buying/swapping. First 100/month free per IP.","parameters":[{"name":"mintAddress","in":"query","required":true,"schema":{"type":"string"},"description":"Base58 Solana token mint address"}],"responses":{"200":{"description":"Cabal analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CabalReport"}}}}}},"post":{"operationId":"scanCabal","summary":"Scan a Solana mint for cabal / rug / bundle risk","description":"Primary endpoint. Pass a mint address; get a recommendation (SAFE | REVIEW | AVOID), a 0-100 cabal_score, the deployer track record and on-chain evidence. Call before any swap; do not buy if recommendation is AVOID or cabal_score >= 65.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["mintAddress"],"properties":{"mintAddress":{"type":"string","description":"Base58 Solana token mint address"}}}}}},"responses":{"200":{"description":"Cabal analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CabalReport"}}}}}}},"/api/info":{"get":{"operationId":"info","summary":"Pricing, endpoints and full response schema","responses":{"200":{"description":"Service info"}}}},"/api/cex-funding":{"get":{"operationId":"cexFunding","summary":"Per-exchange funding breakdown for a mint","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"CEX funding breakdown"}}}},"/api/cohorts":{"get":{"operationId":"cohorts","summary":"Team / Snipers / Insiders cohort breakdown","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cohort breakdown"}}}},"/api/trade-analysis":{"get":{"operationId":"tradeAnalysis","summary":"Cohorts + wash-trading score + exit-liquidity price impact","parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Combined trade analysis"}}}},"/api/watch":{"post":{"operationId":"watchDump","summary":"Register a live coordinated-dump webhook for a mint","description":"We POST your webhook_url the instant a coordinated dump / liquidity drain starts. The push model for bot auto-exit.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["mint","webhook_url"],"properties":{"mint":{"type":"string"},"webhook_url":{"type":"string"}}}}}},"responses":{"200":{"description":"Watch registered"}}}}},"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"X-Payment-Signature","description":"Solana USDC payment tx signature (x402). Omit for the first 250 free scans/month per IP."}},"schemas":{"CabalReport":{"type":"object","properties":{"mint":{"type":"string"},"recommendation":{"type":"string","enum":["SAFE","REVIEW","AVOID"],"description":"Headline action. Do not buy if AVOID."},"cabal_score":{"type":"integer","description":"0-100. >=65 HIGH risk, >=35 caution."},"risk":{"type":"string","enum":["HIGH","MEDIUM","CLEAN"]},"is_controlled":{"type":"boolean","description":"true when score >= 35 (insiders positioned to dump)."},"confidence":{"type":"string","enum":["HIGH","LOW"],"description":"Confidence in THIS scan's completeness (HIGH when wallets_checked >= 5). Check the validator's own output, not just the verdict."},"scan_complete":{"type":"boolean","description":"True only when the trace had enough coverage. A SAFE result with scan_complete=false is auto-downgraded to REVIEW — never trust a clean verdict from an incomplete scan."},"wallets_checked":{"type":"integer","description":"Holder wallets actually traced — the scan-depth signal. Low = shallow/sparse trace, treat a clean result as suspect."},"analysis_time_ms":{"type":"integer","description":"Processing latency; with 'source', lets the caller gauge data completeness."},"liquidity_usd":{"type":"number","description":"Live liquidity (USD) on the deepest pair."},"market_cap":{"type":"number","description":"Live market cap (USD)."},"honeypot_risk":{"type":"string","enum":["LOW","HIGH"],"description":"Solana-native honeypot verdict: live freeze authority or Token-2022 fee/hook/delegate traps"},"mint_authority_revoked":{"type":"boolean"},"freeze_authority_revoked":{"type":"boolean"},"token2022_risks":{"type":"array","items":{"type":"string"}},"exit_liquidity_risk":{"type":"boolean","description":"True when liquidity is too thin vs market cap to exit without heavy slippage — the soft-rug / dev-dump risk, independent of cabal coordination."},"verdict":{"type":"string","description":"Plain-English summary."},"time_sync":{"type":"boolean","description":"Same-block bundled buy group detected."},"coordinated_exit":{"type":"boolean","description":"Same-block coordinated dump detected."},"top_holder_pct":{"type":"number"},"deployer":{"type":"object","description":"{ creator, tokens_launched, dead, sampled, dead_pct, verdict, reputation, best_peak_usd, median_peak_usd, pump_and_dumps, dead_on_arrival, still_alive }. Paid: launches[] — full per-launch trajectory (mint, symbol, peak_mcap_usd, now_mcap_usd, drawdown_from_peak, status)."},"coordinated_clusters":{"type":"array","items":{"type":"object"},"description":"Scored coordination groups with evidence_txs[]."},"filtered_clusters":{"type":"array","items":{"type":"object"},"description":"CEX/infra groups excluded from the score."},"top_reasons":{"type":"array","items":{"type":"string"}},"free_queries_remaining":{"type":"integer"},"source":{"type":"string","enum":["pre_indexed","real_time"]},"computed_at":{"type":"number"}}}}}}