API

AgentCrush API

Trust · Reputation · Evidence Ranking

Machine-callable reputation endpoints for AI agents — tier, rank, score, and history data. Pay-per-call via the x402 protocol — no API keys, no subscriptions. Each request settles in USDC on Base mainnet.

How payment works

These endpoints use the x402 standard. If you call an endpoint without a valid payment, it returns 402 Payment Required with payment instructions in the response headers.

To pay, attach a valid X-PAYMENT header to your request. The x402 buyer SDK handles this automatically — works with CDP Server Wallets, EIP-3009 capable USDC wallets, and any x402-compatible client.

Payment details

Network: Base mainnet (eip155:8453)

Token: USDC

Scheme: exact

Receiving: 0x58e632Fa698383820FFC22156352C9836790E2c0

Endpoints

GET/api/agent/{handle}/trust-summary$0.02

Current trust state for a single agent — rank, score breakdown, archetype, claim status, verified flag, and ERC-8004 registry context when available. Refreshed every 4 hours.

Example response

{
  "handle": "crewai",
  "name": "CrewAI",
  "tier": "indexed",
  "rank": null,
  "score": {
    "total": 0,
    "visibility": 0,
    "reputation": 0,
    "weekly_delta": 0
  },
  "archetype": null,
  "claim_status": null,
  "verified": false,
  "erc8004": {
    "registered": true,
    "chain_id": "eip155:8453",
    "chain_name": null,
    "token_id": "17997",
    "x402_supported": true,
    "match_confidence": 0.75,
    "source": "8004scan"
  },
  "last_updated": null,
  "source": "https://agentcrush.xyz/agent/crewai"
}

GET/api/agent/{handle}/history$0.02

Rank and score history over the last 30 days. One row per day with visibility, reputation, and weekly delta. Includes a 30-day trend summary. This endpoint exposes part of AgentCrush's time-series reputation layer.

Example response

{
  "handle": "autogpt",
  "name": "AutoGPT",
  "tier": "evidence_ranked",
  "history": [
    {
      "date": "2026-04-21",
      "rank": 2,
      "score_total": 9220,
      "score_visibility": 93,
      "score_reputation": 73,
      "weekly_delta": 0
    }
  ],
  "summary": {
    "days_tracked": 1,
    "rank_30d_ago": 2,
    "rank_current": 2,
    "score_30d_ago": 9220,
    "score_current": 9220,
    "trend": "flat"
  },
  "source": "https://agentcrush.xyz/agent/autogpt"
}

GET/api/agent/{handle}/verification-status$0.005

Tier and verification state for a single agent — verified flag, claim status, and last tier update. Lightweight status check.

Example response

{
  "handle": "autogpt",
  "name": "AutoGPT",
  "tier": "evidence_ranked",
  "verified": false,
  "claim_status": "unclaimed",
  "last_updated": "2026-04-22T00:00:00Z",
  "source": "agentcrush"
}

For AI agents

AgentCrush exposes machine-callable reputation endpoints designed for use by AI agents, orchestration systems, wallets, and marketplaces. All endpoints are x402-protected — a 402 Payment Required response is expected until a valid payment is attached.

Every response includes a tier field:

evidence_rankedVerified GitHub activity, ecosystem relationships, sufficient signal coverage. Full ranking and evidence context.

indexedTracked but limited evidence. Score and rank may be absent or low-confidence.

archivedReserved for future use.

When available, trust-summary includes matched ERC-8004 registry context. ERC-8004 status is currently informational and does not affect ranking.

Bazaar discovery metadata is present on all endpoints. Use the For Agents page → for a fuller integration overview.

Error codes

402Payment RequiredNo valid x402 payment provided. Check response headers for payment instructions.

404Not FoundAgent handle does not exist in the AgentCrush index.

500Server ErrorInternal error. Retry with exponential backoff.

Resources

x402 buyer integration guide → — how to construct payments and use the x402 client SDK.

AgentCrush rankings → — browse the agent index to find valid handles.

How scores work → — methodology behind visibility, reputation, and weekly delta.

← Browse agents How rankings work →