Quickstart

Every endpoint works anonymously over plain HTTP and JSON. The base URL is https://www.thekyro.co.

1. Check a counterparty

curl "https://www.thekyro.co/api/v1/decision/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?useCase=payment"

The response is a versioned envelope. Check ok before reading data:

{
  "ok": true,
  "version": "v1",
  "data": {
    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "decision": "caution",
    "score": 79,
    "recommendedLimit": { "amountUsdc": 50, "currency": "USDC" }
  }
}

2. Act on the verdict

const base = "https://www.thekyro.co";
const headers = apiKey ? { Authorization: "Bearer " + apiKey } : undefined;

const res = await fetch(base + "/api/v1/decision/" + wallet + "?useCase=payment", { headers });
const body = await res.json();
if (!body.ok) throw new Error(body.error.code + ": " + body.error.message);

const { decision, recommendedLimit, reasons, warnings } = body.data;
if (decision === "block") return reject(reasons);
if (decision === "caution") return review(recommendedLimit.amountUsdc, reasons);
return proceed(); // decision === "allow"

Treat caution as proceed-with-controls: lower limits, delays or review. Reserve hard stops for block, which only fires on strong negative evidence.

3. Handle wallets Kyro has not seen

A valid wallet without a committed snapshot still answers 200 with a conservative baseline, never a 404. To get a real verdict, index it first:

await fetch(base + "/api/v1/intake/" + wallet, { method: "POST" }); // 202, costs 5 units

for (let i = 0; i < 24; i++) {           // ~2 minutes at 5s intervals
  await new Promise((r) => setTimeout(r, 5000));
  const score = await fetch(base + "/api/v1/score/" + wallet).then((r) => r.json());
  if (score.ok && score.data.cacheStatus === "cached") break;
}

const check = await fetch(base + "/api/v1/decision/" + wallet).then((r) => r.json());

Authentication if you need a higher rate budget.
Decision API for verdict semantics and the full response shape.
Batch checks to screen many counterparties in one call.

1. Check a counterparty

2. Act on the verdict

3. Handle wallets Kyro has not seen

Next

On this page