Trust Score

Overview

Every API in the x402 Relay catalog receives a Trust Score (0-100) that helps AI agents make informed decisions about which APIs to use.

Scoring Factors

Factor	Weight	Description
Protocol Compliance	30%	Valid HTTP 402 response with correct payment-required headers
Uptime	25%	Historical availability based on health check probes
On-chain Activity	25%	Transaction count and volume on Base chain
Community Signals	20%	GitHub activity, documentation quality

Score Tiers

Score	Tier	Badge	Meaning
80-100	Excellent	🟢	Highly trusted, significant on-chain history
60-79	Good	🟡	Verified and reliable
40-59	Fair	🟠	Limited history, but functional
0-39	Low	🔴	New or unreliable

Verification Levels

Tier 1: Protocol Verified (Current)

• HTTP 402 response confirmed
• payment-required header format validated
• payTo, network, price, asset fields extracted

Tier 2: Payment Verified (Planned)

• Small test payment sent and confirmed
• Response quality evaluated after payment
• Refund behavior tested

Tier 3: Audit Verified (Planned)

• Manual or automated security audit
• API behavior consistency over time
• Community vouching / staking

Improving Your Score

1. Ensure proper 402 responses — Follow the x402 Protocol guide
2. Maintain uptime — x402 Relay probes every hour
3. Build on-chain history — More successful transactions = higher score
4. Open-source your code — GitHub activity contributes to community signals