marketing.integrations.integrations.badge
Add AML checks to your product
One API call. Multiple evidence classes. Integrate Sanctuary into your payment flow, trading platform, or compliance pipeline.
Quick start — cURL
COPYcurl -X POST https://api.sanctuary.cv/api/v1/check \
-H "Authorization: Bearer snc_live_<your-key>" \
-H "Content-Type: application/json" \
-d '{"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"}'Response ← live
{
"success": true,
"data": {
"risk_score": 67,
"risk_level": "high",
"chain": "ethereum",
"sources_checked": 22,
"detected_patterns": [
{ "type": "mixer_proximity", "severity": "high" },
{ "type": "velocity_spike", "severity": "medium" }
],
"snapshot_id": "snp_7f3a9b2e...e2d1"
}
}4 ways to integrate
REST API
Basic+Single endpoint for supported chains. POST an address and get a scored JSON response with evidence.
- POST /api/v1/check → full AML check
- GET /api/v1/screen → fast pre-check
- Supports ETH, BTC, TRON, SOL, TON, BSC, Polygon, Arbitrum, Optimism, Base
- Auto chain detection from address format
- JSON response with score, risk level, detected patterns
Webhooks
Pro+Receive real-time alerts when a watched address changes risk level. Cryptographically signed payloads.
- Score change events for watchlisted addresses
- Configurable threshold triggers
- Cryptographically signed payloads for integrity verification
- Automatic retry with exponential backoff
- Failed deliveries logged and retried via dashboard
Telegram Bot
Free+Send any address, get the score. Works on mobile for quick pre-trade checks.
- Inline address scoring
- Risk level badge with top flags
- Watchlist commands (/watch, /unwatch)
- Team access via bot permissions
- Invite-based access via @sanctuary_support
CSV Batch Upload
Basic+Upload up to 10,000 addresses. Get results via dashboard or webhook. Export scored results as CSV.
- Upload .csv with address column
- Background processing with progress indicator
- Results delivered via webhook or dashboard download
- Export scored results to CSV
- Failed rows flagged for retry
Go live in 3 steps
1
Get an API key
2 minutesCreate an account and generate your API key in Settings → API Keys. Keys use the prefix snc_live_ (production) or snc_test_ (sandbox).
2
Send your first check
30 secondsPOST to /api/v1/check with the wallet address. Auto-detection handles chain identification. Response includes score, risk level, and detected patterns.
3
Wire into your flow
your paceAdd policy-based routing: approve, review, block, or quarantine according to your thresholds. Set up webhooks for watchlist alerts.
Rate limits by plan
| Plan | Checks/day | API keys | Bulk | Webhooks |
|---|---|---|---|---|
| Free | 10 | 1 | — | — |
| Basic | 100 | 3 | 20/day | — |
| Pro | 500 | 5 | 100/day | ✓ |
| Enterprise | Unlimited | Unlimited | 1,000/day | ✓ + priority |
Start integrating
Create an API key, test the response shape, and move screening into your product flow.