AML & Compliance

Overview

XentFi’s AML compliance system checks blockchain addresses against global sanctions lists in real‑time. This helps you stay compliant while protecting your business from sanctioned entities.

Sanctions Screening API

Check a Single Address

Endpoint: GET /v1/aml/check/{address} Check if a blockchain address appears on any sanctions list.

curl -X GET https://api.xentfi.com/v1/aml/check/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 \
  -H "apiKey: your-api-key" \
  -H "orgId: your-org-id"

Successful response (clean address):

{
    "data": {
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "isSanctioned": false,
        "identifications": []
    }
}

Sanctioned address response:

{
    "data": {
        "address": "0xSanctionedAddress...",
        "isSanctioned": true,
        "identifications": [
            {
                "category": "sanctions",
                "name": "Entity Name",
                "description": "OFAC sanctions designation",
                "url": "https://ofac.treasury.gov/sanctions/..."
            }
        ]
    }
}

Batch Check (up to 50 addresses)

Endpoint: POST /v1/aml/check-batch Check multiple addresses in one request.

curl -X POST https://api.xentfi.com/v1/aml/check-batch \
  -H "apiKey: your-api-key" \
  -H "orgId: your-org-id" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0"
    ]
  }'

Response:

{
    "data": [
        {
            "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
            "isSanctioned": false,
            "identifications": []
        },
        {
            "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
            "isSanctioned": false,
            "identifications": []
        }
    ]
}

API Reference

Endpoint	Method	Description
`/v1/aml/check/{address}`	GET	Check single address
`/v1/aml/check-batch`	POST	Check up to 50 addresses

Error Responses

Status Code	Description
400	Invalid address format
401	Invalid API key
429	Rate limit exceeded

Error format:

{
    "error": {
        "code": "INVALID_ADDRESS",
        "message": "The provided address format is invalid",
        "timestamp": "2026-08-07T10:30:00.000Z"
    }
}

Best Practices

Screen every address before processing payments.
Keep audit logs of screening results.
Handle rate limits with retry logic.

Webhooks – receive compliance alerts
Payment Links – screened payment processing
Master Wallets – compliance‑ready wallets

Getting Started

Wallet Management

Payment Links & Webhooks

Transfers & Auto Settlement

Security & Compliance

Trading & Liquidity

Agent Tools

Overview

Sanctions Screening API

Check a Single Address

Batch Check (up to 50 addresses)

API Reference

Error Responses

Best Practices

​Overview

​Sanctions Screening API

​Check a Single Address

​Batch Check (up to 50 addresses)

​API Reference

​Error Responses

​Best Practices

​Related Products

Overview

Sanctions Screening API

Check a Single Address

Batch Check (up to 50 addresses)

API Reference

Error Responses

Best Practices

Related Products