REST API for comprehensive wallet sanctions screening, balance checking, and transaction analysis across multiple blockchains.
All API requests require a Bearer token in the Authorization header.
Contact your administrator to obtain an API token. Store it securely and never expose it in client-side code.
/wallet/check
Perform comprehensive wallet verification including sanctions screening, balance checking, and transaction analysis.
{ "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", "protocol": "eth", // Optional: "eth" | "sol" | "btc" | "xrp" | "base" "includeDeBank": true, // Optional: Include DeFi portfolio analysis "primary_email": "client@example.com" // Optional: Filter results by client email }
Use the primary_email
parameter to ensure only records associated with a specific client are returned. This is essential for multi-tenant applications where each client should only access their own verification data.
{ "success": true, "data": { "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", "overallSanctioned": false, "chainalysis": { "isSanctioned": false, "identifications": [] }, "scorechain": { "isSanctioned": false, "details": { "score": 95, "severity": "low" } }, "debank": { "totalUsdValue": 125000.50, "chains": [...], "flaggedTransactionAddresses": [] }, "checkedAt": "2025-01-03T10:30:00Z" }, "meta": { "requestedAt": "2025-01-03T10:30:00Z", "protocol": "eth", "cached": false } }
curl -X POST https://your-domain.com/api/wallet/check \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb", "protocol": "eth", "primary_email": "client@example.com" }'
/wallet/status/:address
Retrieve cached verification results for a previously checked wallet address.
blockchain
(optional): "eth" | "sol" | "btc" | "xrp" | "base" - Default: "eth"curl -X GET "https://your-domain.com/api/wallet/status/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb?blockchain=eth" \ -H "Authorization: Bearer YOUR_API_TOKEN"
/health
Check API health and service availability. No authentication required.
curl -X GET https://your-domain.com/api/health
Comprehensive examples for integrating this API with AI agents, LLMs, and automation tools.
View AI Agents Documentation →400
Bad Request - Invalid parameters401
Unauthorized - Invalid or missing bearer token404
Not Found - Resource not found500
Internal Server Error - Server error occurredAPI requests are subject to rate limiting based on your subscription tier. Cached results are returned when available to reduce API usage.