01/Overview
What Kyro is
Kyro is a pre-transaction counterparty decision layer powered by wallet intelligence and reputation evidence. The decision endpoints are the product surface. Wallet intelligence and the reputation graph are the evidence layer underneath them.
Kyro is not AML or sanctions screening and it does not provide legal, regulatory or compliance determinations. Verdicts, scores and receipts are advisory signals for your own decision process. When evidence is missing, Kyro reports a conservative baseline and tells you what was missing instead of guessing.
| Property | Behavior |
|---|---|
| One envelope | { ok, version, data } on success, { ok, version, error } on failure. On every endpoint. |
| Anonymous by default | Every endpoint works without a key. A key raises the rate budget. |
| Conservative on missing evidence | Unknown wallets get a baseline verdict. Batch rows report no_score instead of a guessed verdict. |
Everything on this page is a summary. The canonical reference for authentication, rate limits, response schemas, reason codes and integration patterns lives at docs.thekyro.co.
02/Decisions
decision_v0.4.1
Three possible verdicts
allow
No caution or block reasons remain.
caution
Soft risk or missing evidence. Proceed with limits or review.
block
Reserved for strong negative evidence: suspicious trust graph, high trust anomaly or high risk penalty.
Missing evidence alone never produces a block. Verdict thresholds are tuned per use case: payment, marketplace, escrow and lending. The full model behavior is documented in the Decision API guide.
03/Quickstart
First call in one minute
No SDK and no API key needed. Call the decision endpoint with any wallet address:
curl https://www.thekyro.co/api/v1/decision/0x1234567890abcdef1234567890abcdef12345678The response is a JSON envelope with the verdict, a recommended USDC limit, reason codes and the evidence behind them. The step-by-step walkthrough, including unknown wallets and batch screening, is the quickstart guide.
04/Reference
v1 · frozen contract
The 8 core endpoints
All paths are relative to https://www.thekyro.co. Every endpoint answers the same versioned JSON envelope and works anonymously.
| Method | Path | Purpose | Reference |
|---|---|---|---|
| GET | /api/v1/decision/:wallet | Allow / caution / block verdict with a recommended USDC limit, reason codes and evidence. | Docs |
| POST | /api/v1/decision/batch | Screen many counterparties in one call. Rows fail individually, never the whole batch. | Docs |
| GET | /api/v1/score/:wallet | Committed reputation score for a wallet with component breakdown and freshness. | Docs |
| GET | /api/v1/trust/:wallet | Verified trust graph for a wallet: transaction-backed relationship edges and graph metrics. | Docs |
| GET | /api/v1/interaction-graph/:wallet | Observed onchain counterparties from saved snapshots, separate from verified trust and score. | Docs |
| GET | /api/v1/profile/:username | Public summary of a registered Kyro identity by username. | Docs |
| POST | /api/v1/decision-receipts | Mint an immutable, shareable receipt of a decision. | Docs |
| GET | /api/v1/decision-receipts/:id | Fetch a receipt exactly as minted. Receipts never change after creation. | Docs |
| POST | /api/v1/intake/:wallet | Start indexing a wallet Kyro has not seen yet. No signature from the owner is needed. | Docs |
Field-level request and response schemas for every endpoint are generated from the OpenAPI contract in the API reference, so they cannot drift from live behavior.
End of document · Decision API · v1
kyro-openapi.yaml