Python SDK

pip install chainscreen

from chainscreen import Client

client = Client(api_key="sk_live_...")

result = client.screen("0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c", "ethereum")
print(result.level)   # "CRITICAL"
print(result.score)   # 100

if result.is_high_risk:
    raise ValueError(f"High-risk address: {result.level}")

batch = client.screen_batch([
    {"address": "0x4f47bc496083c727c5fbe3ce9cdf2b0f6496270c", "chain": "ethereum"},
    {"address": "0x0000000000000000000000000000000000000000", "chain": "ethereum"},
])
print(batch.summary.critical)  # 1
for r in batch.results:
    print(r.address, r.level)

from chainscreen import (
    AuthError, InvalidAddressError,
    QuotaExceededError, RateLimitError, ScreeningError,
)

try:
    result = client.screen(address, chain)
except InvalidAddressError as e:
    print("Bad address:", e)
except QuotaExceededError:
    print("Monthly quota exhausted")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
except AuthError:
    print("Invalid API key")
except ScreeningError as e:
    print(f"API error ({e.status_code}): {e}")

with Client(api_key="sk_live_...") as client:
    result = client.screen(address, chain)