Agent Trust API · Developer Docs

Integrate Know Your Agent in minutes.

One free call tells you whether an on-chain agent is safe to trust. No key, no auth, no SDK required. Base URL: https://coin-three-mu.vercel.app

1 · Check an agent's trust

GET /api/agent/check?address=<wallet>&chain=solana — returns a KYA verdict. Use it as a guardrail before you let an agent transact.

curl

curl "https://coin-three-mu.vercel.app/api/agent/check?address=<wallet>&chain=solana"

JavaScript — guardrail before an agent acts

const r = await fetch(
  `https://coin-three-mu.vercel.app/api/agent/check?address=${agentWallet}&chain=solana`
);
const trust = await r.json();
// { level: "trusted"|"neutral"|"caution"|"unknown", score, reasons[], verified }
if (trust.level === "caution") {
  throw new Error(`Blocked: agent ${agentWallet} — ${trust.reasons[0]}`);
}

Python

import requests
t = requests.get("https://coin-three-mu.vercel.app/api/agent/check",
    params={"address": wallet, "chain": "solana"}).json()
if t["level"] == "caution":
    raise RuntimeError(f"Blocked agent: {t['reasons'][0]}")

Response

{
  "address": "<wallet>",
  "chain": "solana",
  "score": 62,                 // 0-100
  "level": "neutral",          // trusted | neutral | caution | unknown
  "reasons": ["Identity verified — …", "…"],
  "verified": true,            // proved wallet ownership
  "registered": true
}

2 · Embed a live trust badge

A self-updating SVG that links to the agent's permanent KYA profile. Drop it in a README, dashboard, or agent card.

HTML / Markdown

<a href="https://coin-three-mu.vercel.app/agents/solana-<wallet>">
  <img src="https://coin-three-mu.vercel.app/api/agent/badge?address=<wallet>&chain=solana"
       alt="GL1TCH Agent Trust" width="360" height="84" />
</a>

3 · Let your agent self-register

Agents are programmatic — yours proves ownership by signing a message with its own keypair (moves no funds, grants no access). Verified identity raises its trust.

JavaScript (ed25519 / Solana)

import nacl from "tweetnacl";
import bs58 from "bs58";

const issued = Date.now();
const msg = `GL1TCH Agent Registration
Wallet: ${address}
Issued: ${issued}
This proves wallet ownership. It moves no funds and grants no access.`;
const signature = bs58.encode(
  nacl.sign.detached(new TextEncoder().encode(msg), secretKey)
);

await fetch("https://coin-three-mu.vercel.app/api/agent/register", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ address, chain: "solana", issued, signature }),
}); // → { ok: true }

4 · ERC-8004 (Trustless Agents) compatible

ERC-8004 is the emerging open standard for agent identity + reputation (MetaMask, Ethereum Foundation, Google, Coinbase). GL1TCH emits an ERC-8004-compatibleAgent Registration File, with our trust score mapped into the standard's Reputation-Registry feedback shape — so any framework that already speaks ERC-8004 can consume GL1TCH signals with zero custom glue.

curl

curl "https://coin-three-mu.vercel.app/api/agent/erc8004?address=<wallet>&chain=solana"
# → { "type": ".../eip-8004#registration-v1", "supportedTrust": ["reputation"],
#     "reputation": { "value": <score>, "tag1": "<level>", "clientAddress": "GL1TCH" }, ... }

GL1TCH is an off-chainsignal provider — we don't deploy the on-chain Identity Registry (ERC-721); that stays the operator's choice. We give ERC-8004 consumers a portable, standard-shaped reputation feed.

Notes

Free. Rate-limited per IP (generous). Depth + bulk access will tie to holding $GL1TCH — usage becomes revenue.
GL1TCH is a reputation & provenance signal, not key custody. It never touches an agent's keys or yours.
A verdict is a risk signal, not a guarantee — and never financial advice.
AI agents: a machine-readable summary lives at /llms.txt.

← Know Your Agent Agent directory →