Scan wallet risk, verify sender intent, and block fraudulent transfers in real time. Sub-2s response. Simple REST integration. Go live in 48 hours.
Exchange sends wallet address + transaction metadata to TrustGuard API before confirming the send.
Cross-references 2.4M+ flagged wallets, behavioral patterns, transaction velocity, and geo signals.
Optional: user prompted with 5 targeted fraud-detection questions. Returns intent score alongside wallet risk.
API returns risk score, flags, and recommendation: allow / warn / block.
Cross-chain wallet database covering known scam clusters, mixer patterns, high-velocity activity, and reported fraud addresses. Updated continuously from on-chain data and community reports.
Dynamic questioning engine that probes sender intent. Detects romance scam patterns, investment fraud signals, urgency pressure, and third-party instruction — patterns invisible to wallet-only scans.
Sender IP geolocation and location anomaly detection. Flags mismatches between declared sender region and actual IP origin. Logged to every transaction audit trail.
Sub-2s JSON response. Simple REST integration. Returns composite risk score, individual signal flags, and a clear machine-readable recommendation. Drop-in ready for any tech stack.
No marketing language. This is what TrustGuard does to your bottom line and your compliance posture.
Block fraudulent transactions at the point of intent — before funds move and before the loss is irreversible.
EU MiCA, UK FCA, and African financial regulators are mandating exchange-level fraud controls. TrustGuard is audit-trail ready.
Users who feel protected stay longer. Exchanges with fraud protection see lower churn after fraud incidents.
Sub-2s API response means the fraud check is invisible to your users. Zero friction on legitimate transactions.
POST to /v1/scan with wallet address, chain, and amount before confirming any send.
JSON response in under 2 seconds. Risk score 0–100, risk level, fraud flags, geo anomaly signal, and intent score if verification was enabled.
Use the recommendation field to automate your decision. Override anytime for custom thresholds.
Beta metrics only. We only publish what we can verify.
All API communication over TLS 1.3. Wallet data is not stored after scan completion.
TrustGuard never touches, holds, or routes any funds. Read-only risk analysis only.
Minimal data collection. No PII required to scan a wallet. GDPR-aligned data handling.
Every flagged transaction logged with timestamp, sender signals, and recommendation. Available for regulatory review on request.
Book a 20-minute live demo. We will walk your team through a real transaction scan, show the detective interview system, and answer your technical questions.
Real-time fraud detection for crypto transactions. This documentation covers everything your engineering team needs to integrate TrustGuard into your exchange or wallet application.
Make your first API call in under 5 minutes.
Email api@gettrustguard.com with your exchange name and estimated monthly transaction volume. We will provision your API key within 24 hours.
All API requests require a valid API key passed as a Bearer token in the Authorization header.
| Parameter | Type | Required | Description |
|---|---|---|---|
| wallet_address | string | Yes | The recipient wallet address to scan |
| chain | string | Yes | Blockchain: ethereum, bitcoin, tron, bnb, solana, xrp |
| transaction_amount | number | No | Transaction value in USD. Improves risk scoring accuracy. |
| user_id | string | No | Your internal user ID for audit trail linkage |
| include_intent | boolean | No | Enable 5-question behavioral fraud interview. Returns intent_score. |
| Field | Type | Description |
|---|---|---|
| wallet_risk_score | integer | 0 = safe, 100 = confirmed fraud. Composite score across all detection layers. |
| risk_level | string | Human-readable risk tier: low / medium / high / critical |
| flags | array | Machine-readable fraud signals. Empty array = no flags detected. |
| user_intent_score | integer | Behavioral fraud score from sender interview. Only present when include_intent: true. |
| geo_anomaly | boolean | True if sender IP location conflicts with declared or expected location. |
| recommendation | string | allow_transaction / warn_user / block_transaction. Use this to drive your logic. |
| response_time_ms | integer | Total API processing time in milliseconds. |
Initiates the 5-question behavioral fraud detection interview. Returns a session_token and the first question. Your UI presents questions sequentially and posts answers back. The session closes with a final intent_score.
Questions probe: purpose of transaction, relationship to recipient, known location, urgency pressure, and return promises. Each answer is weighted by fraud pattern prevalence.
The composite risk score is derived from four signal layers, each weighted by predictive strength:
| Signal Layer | Inputs |
|---|---|
| Wallet history | Transaction count, age, known fraud database matches, mixer usage patterns |
| Known fraud databases | 2.4M+ indexed scam wallets, community-reported addresses, cross-chain cluster analysis |
| Behavioral signals | Sender interview answers, urgency indicators, third-party instruction flags |
| Geo anomalies | Sender IP vs declared location, VPN/proxy detection, jurisdiction risk signals |
| Plan | Requests/sec | Requests/month |
|---|---|---|
| Starter | 10 req/s | 500,000 |
| Exchange | 100 req/s | 50,000,000 |
| Enterprise | Custom | Unlimited |
Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.
TrustGuard can push event notifications to your endpoint when key fraud events occur.
| Event | Triggered when |
|---|---|
| transaction.flagged | Risk score exceeds your configured warn threshold |
| transaction.blocked | Recommendation is block_transaction |
| wallet.newly_indexed | A wallet you previously scanned is newly added to the scam database |
Configure webhook URLs in your dashboard after API key provisioning. All webhook payloads are signed with HMAC-SHA256.
The API follows standard REST conventions and works with any language or framework. The curl and Python examples in this documentation are copy-paste ready. JavaScript, Go, and PHP wrappers are coming in Q3 2025.
System status and uptime history:
Target SLA: 99.9% uptime. Contact api@gettrustguard.com to report incidents.
Questions? Email api@gettrustguard.com — we respond within 24 hours.
Investor inquiries: investors@gettrustguard.com
© 2025 Trust God Company · Kodiya Nekara