GroupButler White-Label Anti-Scam API

Scan scam text in any app — free, read-only, attributed. Embed GroupButler's scam detector in your wallet, trading bot or community app. One call returns a risk verdict. No signup.

Add the bot to your group → Live health check

Why

Telegram scam text ("verify your wallet", fake-airdrop links, fake-admin support) is copy-pasted across wallets, DMs and mini-apps. The same scanner that protects Web3 Telegram groups is exposed here as a free utility, so any builder can add a "is this a scam?" check in minutes.

Quickstart

curl -s -X POST https://bc.gensi.space/whitelabel/v1/scan \
  -H 'content-type: application/json' \
  -d '{"text":"URGENT: verify your wallet at http://claim-airdrop.xyz to unlock your reward"}'

Response:

{
  "ok": true,
  "score": 68,
  "verdict": "high_risk",
  "signals": ["wallet-action-urgency","free-money-bait","urgency-pressure","bait-link-pattern"],
  "urls_found": 1,
  "mode": "heuristic-beta",
  "protected_by": "GroupButler"
}

Endpoints

MethodPathBody / QueryReturns
GET/whitelabel/v1/health—service status + version + mode
POST/whitelabel/v1/scan{"text":"..."} or {"texts":[...]}risk verdict per text (≤50/batch)
GET/whitelabel/v1/scan?q=...—single-text convenience scan (demo)

Verdict thresholds

scoreverdictmeaning
0–24cleanno strong scam signal
25–54suspiciousreview before acting
55–100high_riskblock / warn the user

Attribution & tiers

Every response includes X-Protected-By: GroupButler and protected_by in the body. The free tier is the lexical beta above. Higher-throughput / semantic + on-chain endpoints are planned (x402-metered paid tier); the full engine already runs inside the GroupButler bot.

Red lines: read-only, idempotent, no user data stored. Not financial advice. Demo/test data is labelled. © GroupButler (Gensi).

FAQ

Is it free? Yes — free, read-only; you embed it, we get the attribution.

Does it include on-chain checks? Not in the free v0 (lexical only). The bot has the full engine.

Is it financial advice? No — a risk signal only.

← Back to GroupButler