kya — Know Your Agent
Trust scoring for AI agents. Check any wallet's trust score, verify ERC-8004 identity, get tier. Zero dependencies.
pip install agent-kya
Quick start
from kya import check, is_trusted
# Trust score (0–100) — FREE, no API key
result = check("0xABC...")
print(result["score"]) # 73
print(result["tier"]) # "trusted"
# Quick boolean
if is_trusted("0xABC...", min_score=50):
# safe to transact
pass
API
Free (no API key)
| Function | What it does |
|---|---|
check(address) |
Trust score 0–100, tier, components, blocked status |
verify(address) |
ERC-8004 identity verification |
tier(address) |
Trust tier + transaction limits |
batch_check(addresses) |
Batch trust check (max 10) |
framework() |
Scoring methodology, tiers, endpoints |
is_trusted(address, min_score=50) |
Quick boolean |
Premium ($0.01/query via x402)
| Function | What it does |
|---|---|
deep_analysis(address) |
Behavioral signals, velocity scoring, anomaly flags, recommendation |
Examples
Check before paying
from kya import check
trust = check("0xABC...")
if trust["blocked"]:
raise Exception("Agent is sanctioned")
if trust["score"] < 20:
raise Exception("Trust too low")
# proceed...
Verify identity
from kya import verify
result = verify("0xABC...")
if not result["verified"]:
print("Not a registered agent")
Batch
from kya import batch_check
results = batch_check(["0xAgent1...", "0xAgent2..."])
for r in results:
print(r["address"], r["score"], r["tier"])
Trust tiers
| Tier | Score | Max per TX |
|---|---|---|
| Open | 0–19 | $1 |
| Verified | 20–49 | $1,000 |
| Trusted | 50–79 | $10,000 |
| Enterprise | 80–100 | Unlimited |
License
MIT — AsterPay
1 maintainer
Release files for agent-kya 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_kya-0.1.0.tar.gz | 3.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_kya-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.4 kB
Release files / agent_kya-0.1.0.tar.gz
| Download URL | agent_kya-0.1.0.tar.gz |
|---|---|
| Size | 3.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ad144e9913f59aca605b0bf47543bfc04f7e3e601bd3d03e0ca6889ad92d97c
|
|
BLAKE2b-256 checksum How to use checksums |
0f70a9b1b95614b7f8f1e55ddda3dc09dfc802c1ebcf10a6501e1953566c202c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Release files / agent_kya-0.1.0-py3-none-any.whl
| Download URL | agent_kya-0.1.0-py3-none-any.whl |
|---|---|
| Size | 3.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6df1628a46738d7a4052edf15136ae8adc4a07aa97924acf98b7cd2571559122
|
|
BLAKE2b-256 checksum How to use checksums |
8a4bbdd38f17e0e86dc8b6c6da593c715e74fc74f16b706735f29a1f143e3007
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
