Explained trust score for an ERC-8004 agent, with positives, cautions, and tier breakdown.
What it does
This endpoint is part of the ERC-8004 Trust API ("The Oracle") provided by 8k4protocol. It returns a detailed, explained trust score for a specific on-chain agent identified by its ERC-8004 agent ID. The response includes the numeric score, score tier, trust tier, confidence level, adjustment reasons, and human-readable lists of positives and cautions that contributed to the score.
The specific endpoint `/agents/21480/score/explain` is scoped to agent ID 21480, but the API pattern `/agents/{agent_id}/score/explain` works for any valid agent ID (0–10,000,000). An optional `chain` query parameter (bsc, base, eth; defaults to bsc) lets callers select which blockchain registration to evaluate. Payment is handled via the x402 protocol on Base (eip155:8453) at a fixed price of $0.001 per call, settled through the Coinbase CDP facilitator. The payment recipient is `0xb273616670037C0870E9835B3FFBE68f58de68B0`.
The response schema (`ScoreExplainResponse`) includes fields such as `score`, `score_tier`, `trust_tier`, `confidence`, `adjusted`, `adjustment_reasons`, `positives`, `cautions`, `global_id`, `as_of` timestamp, and a `disclaimer`. This makes it suitable for agents or applications that need not just a trust number but an interpretable breakdown of why an agent received its score. The broader API also offers agent search, metadata management, validation history, wallet lookups, and identity resolution across chains.
Capabilities
Use cases
- —Evaluate the trustworthiness of an ERC-8004 registered agent before delegating a task
- —Display a human-readable trust breakdown (positives and cautions) in an agent marketplace UI
- —Automate agent selection by filtering on trust tier and confidence level
- —Audit why a specific agent's score was adjusted or flagged
Fit
Best for
- —AI agent orchestrators that need to vet peer agents before interaction
- —Decentralized agent marketplaces displaying trust badges
- —Automated pipelines requiring programmatic trust gating on ERC-8004 agents
Not for
- —General-purpose credit scoring or human identity verification
- —Agents not registered under the ERC-8004 standard
- —Use cases requiring free/unauthenticated bulk access (each call costs $0.001)
Quick start
curl -X GET "https://api.8k4protocol.com/agents/21480/score/explain?chain=bsc" \
-H "X-Payment: <x402_payment_token>"Example
Response
{
"as_of": "2025-01-15T12:00:00Z",
"chain": "bsc",
"score": 72.5,
"adjusted": false,
"agent_id": 21480,
"cautions": [
"Limited validator diversity"
],
"global_id": "bsc:21480",
"positives": [
"Multiple positive validations from distinct wallets",
"Active on-chain for over 30 days"
],
"confidence": "medium",
"disclaimer": "Scores are informational and not financial advice.",
"score_tier": "good",
"trust_tier": "trusted",
"score_version": 2,
"adjustment_reasons": []
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models for this endpoint, clear x402 pricing, and a live probe that returned 200 on GET. Docs link exists but was not crawled; example response is inferred from the ScoreExplainResponse schema rather than observed.
Warnings
- —The probe returned HTTP 200 (not 402) on GET, suggesting the endpoint may currently be accessible without payment or the x402 challenge was not triggered for this specific agent ID.
- —External documentation at https://8k4protocol.com/docs/ was not crawled; some behavioral details are inferred from the OpenAPI spec alone.
- —Example response values are synthetic, derived from the schema; no real response body was captured.
Citations
- —The endpoint is documented as GET /agents/{agent_id}/score/explain with x402 payment at $0.001 on Base (eip155:8453)https://api.8k4protocol.com/openapi.json
- —The API is titled 'ERC-8004 Trust API' version 1.2.0, described as 'The Oracle - Read-only API for agent trust scores'https://api.8k4protocol.com/openapi.json
- —The payment recipient address is 0xb273616670037C0870E9835B3FFBE68f58de68B0 with Coinbase CDP facilitatorhttps://api.8k4protocol.com/openapi.json
- —The root endpoint returns status ok and references docs at https://8k4protocol.com/docs/https://api.8k4protocol.com