x402basequality 0.82

ERC-8004 agent trust scores and network stats via x402-paid API on Base

Price
per_call
Protocol
x402
Verified
no

What it does

The ERC-8004 Trust API ("The Oracle") by 8k4protocol provides read-only access to on-chain agent trust scores, validations, metadata, and network statistics. It implements the ERC-8004 standard for agent identity and reputation across multiple chains (BSC, Base, Ethereum). The `/stats` endpoint specifically returns aggregate network statistics including total agents, total validations, scored agents, average score, and confidence-level breakdowns.

The API exposes a rich set of endpoints: agent trust score lookups (`/agents/{id}/score`), score explanations (`/agents/{id}/score/explain`), agent search with trust-tier filtering (`/agents/search`), agent cards (`/agents/{id}/card`), validation history (`/agents/{id}/validations`), wallet-to-agent mappings (`/wallet/{wallet}/agents`), identity resolution (`/identity/{global_id}`), metadata upload and retrieval, and the stats endpoint listed here. Most paid endpoints cost $0.001 per call; the `/stats` endpoint costs $0.01 per call; metadata upload costs $0.10. All payments settle via x402 on Base (eip155:8453) through the Coinbase CDP facilitator. A free `/stats/public` endpoint is also available with API key authentication.

The API is documented via OpenAPI 3.1.0 (version 1.2.0) and supports chain filtering (bsc, base, eth) on most endpoints. Authentication uses either x402 payment headers or API keys generated through wallet signature verification.

Capabilities

agent-trust-scoreerc-8004on-chain-reputationagent-searchagent-metadatavalidation-historywallet-agent-lookupidentity-resolutionnetwork-statsmulti-chainx402-paymentbase-l2

Use cases

  • Look up the trust score and tier of an ERC-8004 registered agent before delegating a task
  • Search for high-trust agents capable of a specific task across BSC, Base, or Ethereum
  • Retrieve aggregate network statistics on agent registrations and validation activity
  • Verify an agent's validation history and on-chain feedback before interacting with it
  • Resolve a global agent ID to its chain-specific registrations

Fit

Best for

  • AI agent orchestrators that need to vet other agents before delegation
  • Dashboards displaying ERC-8004 network health and agent leaderboards
  • Multi-agent systems requiring trust-based routing decisions
  • Developers building on the ERC-8004 agent identity standard

Not for

  • General-purpose blockchain data queries unrelated to agent trust
  • Applications needing real-time transaction monitoring or event streaming
  • Use cases requiring write access to on-chain agent registrations (this API is read-only plus metadata upload)

Quick start

# Get network stats (paid, $0.01 via x402 on Base)
curl https://api.8k4protocol.com/stats

# Free public stats (requires API key)
curl -H 'X-API-Key: YOUR_KEY' https://api.8k4protocol.com/stats/public

Example

Response

{
  "chains": {
    "bsc": {
      "total_agents": 800
    },
    "eth": {
      "total_agents": 150
    },
    "base": {
      "total_agents": 300
    }
  },
  "new_count": 270,
  "total_agents": 1250,
  "average_score": 72.5,
  "scored_agents": 980,
  "total_validations": 8430,
  "low_confidence_count": 280,
  "high_confidence_count": 120,
  "medium_confidence_count": 340,
  "minimal_confidence_count": 240
}

Endpoint

Transporthttp
Protocolx402
Pay to0xb273616670037C0870E9835B3FFBE68f58de68B0
CurrencyUSD COIN

Quality

0.82/ 1.00

Full OpenAPI 3.1.0 schema with detailed component definitions, clear x402 pricing annotations, and well-structured endpoints. The /stats endpoint returned 200 on GET (probe note says it did not return 402, suggesting it may be accessible without payment in some cases). Docs URL referenced but not crawled. Response example is illustrative based on the StatsResponse schema, not from a live capture.

Warnings

  • The probe shows /stats returned HTTP 200 on GET rather than 402, which may mean the x402 gate is not enforced or was bypassed; the OpenAPI spec declares it as paid ($0.01).
  • External documentation at https://8k4protocol.com/docs/ was not crawled; details beyond the OpenAPI spec are unavailable.
  • The example response JSON is synthesized from the schema, not captured from a live call.

Citations

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 02:18:38Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-22

Agent access