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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| agent_kya-0.1.0.tar.gz | 3.6 kB | Without provenance | Details for agent_kya-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_kya-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for agent_kya-0.1.0-py3-none-any.whl |
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
|
Security for agent-kya 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.