Wallet Verification API

REST API for comprehensive wallet sanctions screening, balance checking, and transaction analysis across multiple blockchains.

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_TOKEN

Contact your administrator to obtain an API token. Store it securely and never expose it in client-side code.

Base URL

https://your-domain.com/api

Endpoints

POST/wallet/check

Perform comprehensive wallet verification including sanctions screening, balance checking, and transaction analysis.

Request Body

{
  "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
}
Multi-Tenant Filtering

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.

Response (200 OK)

{
  "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 Example

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"
  }'
GET/wallet/status/:address

Retrieve cached verification results for a previously checked wallet address.

Query Parameters

  • blockchain (optional): "eth" | "sol" | "btc" | "xrp" | "base" - Default: "eth"

cURL Example

curl -X GET "https://your-domain.com/api/wallet/status/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb?blockchain=eth" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
GET/health

Check API health and service availability. No authentication required.

cURL Example

curl -X GET https://your-domain.com/api/health

AI Agent Integration

Comprehensive examples for integrating this API with AI agents, LLMs, and automation tools.

View AI Agents Documentation →

Error Codes

400Bad Request - Invalid parameters401Unauthorized - Invalid or missing bearer token404Not Found - Resource not found500Internal Server Error - Server error occurred

Rate Limits

API requests are subject to rate limiting based on your subscription tier. Cached results are returned when available to reduce API usage.

  • ScoreChain checks are cached for 24 hours
  • Chainalysis checks are always fresh (not cached)
  • Balance data is cached for 24 hours