{"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-rug 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. 100 free queries/month per IP, no signup; then 0.02 USDC per query via x402.","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 100 free queries/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"]},"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 }"},"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"}}}}}}