kyonis 1.0.1

Python SDK for Kyonis — Agent-native KYC/AML compliance API

Kyonis Python SDK

Agent-native KYC/AML compliance API. Screen sanctions, verify identities, and run due diligence in 3 lines of Python.

Installation

pip install kyonis

Quick Start

from kyonis import Client

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

# AML Sanctions Screening (< 500ms)
result = client.aml.screen(name="John Doe", country="US")
print(result["risk_level"])   # "clear" | "low" | "medium" | "high" | "critical"
print(result["reasoning"])    # Human-readable explanation

# KYC Verification (< 3s)
kyc = client.kyc.verify(
    nom="Dupont",
    prenom="Jean",
    date_naissance="1990-01-15",
    nationalite="FR",
)
print(kyc["risk_score"])
print(kyc["reasoning"])

# Due Diligence (< 10s)
dd = client.due_diligence.run(
    entity_name="Acme Corp",
    entity_type="company",
    country="FR",
    depth="enhanced",
)

Features

Feature	Method	Response Time
Sanctions Screening	client.aml.screen()	< 500ms
KYC Verification	client.kyc.verify()	< 3s
Due Diligence	client.due_diligence.run()	< 10s
UBO Resolution	client.ubo.resolve()	< 5s
Entity Risk	client.entity.get_risk()	< 200ms
GDPR Export	client.gdpr.export()	-
GDPR Erasure	client.gdpr.erase()	-

Error Handling

from kyonis import Client, RateLimitError, AuthenticationError
import time

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

try:
    result = client.aml.screen(name="Test")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited. Retry in {e.retry_after}s")
    time.sleep(e.retry_after)

Links

• Dashboard: https://app.kyonis.com
• Documentation: https://docs.kyonis.com
• GitHub: https://github.com/contactkyonis-droid/kyonis-mcp
• API Reference: https://docs.kyonis.com/api-reference/overview

License

MIT