KYCAML.ai KYCAML.ai | API | Contact | Pricing
Free Blockchain AML Scan
Register

API Documentation

KYCAML.ai Blockchain AML Scanning API

Quick Start

Get started with the KYCAML.ai Blockchain AML Scan API in minutes.

Base URL:
https://gateway.kycaml.ai/apis/blockchain-aml-scan/

1. Get Your API Key

Navigate to the Register or Login to access your API Keys.

2. Make Your First Request

curl -X POST https://gateway.kycaml.ai/apis/blockchain-aml-scan/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "action": "check"
  }'

Authentication

All API requests require authentication using your API key.

Authorization Header (Recommended)

Authorization: Bearer kycaml_live_[account_hash]_[key]

Query Parameter

?api_key=kycaml_live_[account_hash]_[key]

Endpoints

POST GET Check Wallet

Quick lookup to check if a wallet address is flagged in our database.

Endpoint
https://gateway.kycaml.ai/apis/blockchain-aml-scan/
Parameters
Parameter Type Required Description
address string Yes Blockchain wallet address to check
action string No Action type: check (default), analyze, or batch
Example Request
curl -X POST https://gateway.kycaml.ai/apis/blockchain-aml-scan/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "action": "check"
  }'
Example Response
{
  "success": true,
  "data": {
    "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "is_flagged": true,
    "risk_score": 0.85,
    "category": "High Risk"
  },
  "metadata": {
    "account_hash": "abc123...",
    "account_type": "professional",
    "action": "check",
    "response_time_ms": 45,
    "timestamp": "2025-11-07T02:00:00+00:00"
  }
}

POST Risk Analysis

AI-powered risk scoring using machine learning models.

Example Request
curl -X POST https://gateway.kycaml.ai/apis/blockchain-aml-scan/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "action": "analyze"
  }'

POST Batch Check

Check multiple wallet addresses at once (maximum 100 per request).

Example Request
curl -X POST https://gateway.kycaml.ai/apis/blockchain-aml-scan/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xabc...,0xdef...,0x123...",
    "action": "batch"
  }'

Rate Limits

Plan Price Team Members API Calls / Day
Start-Up $10/month or $100/year 2 100
Business $100/month or $1,000/year 5 1,000
Corporate $500/month or $5,000/year 10 10,000
Service Provider $1,000/month or $10,000/year Unlimited Unlimited
Rate Limit Exceeded
When you exceed your rate limit, you'll receive a 429 Too Many Requests response with a retry_after value in seconds.

Error Codes

Code Status Description
400 Bad Request Missing or invalid parameters
401 Unauthorized Invalid or missing API key
403 Forbidden Insufficient permissions
429 Too Many Requests Rate limit exceeded
500 Internal Server Error Server error occurred

Need Help?

If you have questions or need assistance:

Get Your API Key Back to Home