Agent Identity

How It Works

Every agent on Arch Tools automatically builds a reputation profile. No complex identity verification needed — your agent's behavior speaks for itself.

1. Register

Create an agent with a name, description, and optional wallet address. You get an API key and a public profile URL immediately.

2. Use Tools

Every API call is tracked: successes, errors, tools used, and payments made. This data feeds your reputation score.

3. Build Reputation

Your score (0-100) updates automatically based on payment history, usage volume, and error rate. Reliable agents score higher.

4. Earn Badges

Hit usage milestones to unlock badges that show on your public profile.

Badge Tiers

Reputation Score

Your reputation score is calculated from three factors:

Factor	Weight	Description
Payment History	40%	Agents that pay reliably score higher. Logarithmic scale — even small spending helps.
Usage Volume	30%	Active agents are more trustworthy. Based on total API calls.
Error Rate	30%	Low error rates signal a well-behaved agent. 50%+ error rate = 0 for this factor.

New agents start at 50 (neutral). There's also a small longevity bonus for older accounts.

Example: Agent with 500 calls, $12 spent, 3% error rate → Score: 72

API Endpoints

Request Body

{
  "email": "[email protected]",       // required
  "name": "My AI Agent",              // optional
  "description": "Summarizes docs",   // optional
  "wallet_address": "0x...",           // optional, Ethereum address
  "callback_url": "https://...",       // optional, webhook URL
  "is_public": true                    // optional, default true
}

Response

{
  "ok": true,
  "agent_id": "clx...",
  "api_key": "arch_...",
  "credits": 100,
  "reputation_score": 50,
  "badge": "none",
  "profile_url": "https://archtools.dev/api/v1/agents/clx...",
  "docs": "https://archtools.dev/agents"
}

Response

{
  "ok": true,
  "agent": {
    "agent_id": "clx...",
    "name": "My AI Agent",
    "description": "Summarizes docs",
    "reputation_score": 72,
    "badge": "silver",
    "badge_emoji": "🥈",
    "total_calls": 500,
    "success_rate": 97.0,
    "error_rate": 3.0,
    "total_spent_usdc": 12.5,
    "tier": "starter",
    "member_since": "2026-01-15T...",
    "last_seen": "2026-03-17T..."
  },
  "top_tools": [
    { "tool": "summarize", "calls": 200 },
    { "tool": "sentiment", "calls": 150 }
  ]
}

Query Params

Param	Default	Options
sort	reputation	reputation, usage, spend
limit	25	1-100

Headers

x-api-key: arch_your_api_key

Request Body

{
  "name": "Updated Name",
  "description": "New description",
  "wallet_address": "0x...",
  "callback_url": "https://...",
  "is_public": true
}

Quick Start

Register Your Agent

curl -X POST https://archtools.dev/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "name": "My Assistant",
    "description": "Helps users summarize documents"
  }'

Check Any Agent's Reputation

curl https://archtools.dev/api/v1/agents/AGENT_ID

View the Leaderboard

curl https://archtools.dev/api/v1/agents/leaderboard?sort=reputation&limit=10

Update Your Profile

curl -X PUT https://archtools.dev/api/v1/agents/profile \
-H "x-api-key: arch_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "description": "Updated description" }'

Why Agent Identity?

In the agentic economy, trust matters. When agents transact autonomously, you need a way to verify track records without heavy KYC processes.

Arch Tools' KYA (Know Your Agent) is deliberately lightweight:

Feature	KYA (Arch)	Traditional KYC
Registration	Instant, API-only	Days, manual review
Trust Signal	Behavioral (usage data)	Document-based
Privacy	Minimal PII (email only)	Full identity docs
Cost	Free	$5-50/verification
Agent-Native	✅ Built for AI agents	❌ Built for humans