# x402 Trust Bulk Score Lookup

> x402 Trust Bulk Score Lookup is a paid API for AI agents from x402-trust.com, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-15).

Returns trust, reputation, and reliability scores for up to 200 x402 endpoints in a single batch call, including uptime stats, compliance grades, on-chain settlement volume, and a proceed/avoid recommendation.

## Facts

- Endpoint: POST https://x402-trust.com/v1/x402-trust-bulk-200
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-trust-bulk-score-lookup-347943bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JRjvKfCGzkdO1y5WB8Qpm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-trust-bulk-score-lookup-347943bc -d '<json body>'
```

Example prompt: Can you pull the x402 Trust bulk scores for these three endpoints — https://api.example.com/v1/thing, https://api.foo.com/weather, and https://api.bar.com/search — and tell me which ones are safe to pay and which to avoid?

## When to prefer this

Use this endpoint when you need to evaluate the trustworthiness of multiple x402 endpoints in a single call — particularly when your agent is deciding whether to send USDC payments to APIs it hasn't used before. Prefer this over single-endpoint lookups when you have 2–200 URLs to check at once. It is especially valuable for agent orchestration systems that dynamically discover and vet x402 services before paying them.

## Known failure modes

- Unknown endpoint URL returns found:false with null score and grade
- Malformed resource URL in the array may cause a validation error
- Requesting more than 200 resources in one call may be rejected or truncated
- Stale probe data (live:false) may mean scores reflect older measurements
- Low confidence score when endpoint has limited observation history

## How this service works

Trust, reputation & reliability scores for x402 endpoints. We monitor every listed x402 service 24/7: uptime probes, 402-envelope compliance, price history, and real on-chain USDC settlement volume. Free grade & recommendation for any endpoint, $0.005 for a full data breakdown.

## Output

A JSON object containing an array of per-endpoint results (up to 200), each with a letter grade (A–F), numeric score, 30-day uptime probe stats, 402-envelope compliance count, on-chain USDC settlement volume, distinct payer count, average latency, price change history, a proceed/avoid recommendation, confidence score with breakdown, sub-scores for technical reliability, spec compliance, and economic reputation, plus a scoreRange and flags. Endpoints not found in the index return a minimal not-found record.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "resources": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tier": 10,
  "results": [
   {
    "flags": [],
    "found": true,
    "grade": "A",
    "score": 87.4,
    "stats": {
     "payTo": "0x1111111111111111111111111111111111111111",
     "delisted": false,
     "probes30d": 144,
     "payToStale": false,
     "probeOk30d": 143,
     "firstSeenTs": 1748707200000,
     "avgLatencyMs": 210,
     "observedDays": 30,
     "latencyVantage": "measured from a single EU vantage point; includes network round-trip distance to the endpoint",
     "settlements30d": 52,
     "payToLastSeenTs": 1751299100000,
     "payToSharedWith": 0,
     "priceChanges30d": 0,
     "settlementAsset": "USDC",
     "envelopeValid30d": 144,
     "distinctPayers30d": 14,
     "settlementDecimals": 6,
     "settledVolumeUsd30d": 5.2,
     "settledVolumeUnits30d": "5200000"
    },
    "resource": "https://api.example.com/v1/thing",
    "breakdown": {
     "age": 0.7,
     "uptime": 0.99,
     "latency": 0.85,
     "activity": 0.6,
     "stability": 1,
     "compliance": 1
    },
    "freshness": {
     "live": false,
     "ageSeconds": 100,
     "probedAtTs": 1751299100000
    },
    "probed_at": 1751299100000,
    "subscores": {
     "economicConfidence": 0.6,
     "specComplianceScore": 100,
     "economicReputationScore": 71,
     "technicalReliabilityScore": 92
    },
    "templated": false,
    "advertised": {
     "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     "amount": "10000",
     "network": "eip155:8453",
     "decimals": 6,
     "amountUsd": 0.01,
     "observedAtTs": 1751299100000
    },
    "confidence": 0.82,
    "probes_30d": 144,
    "recomputed": true,
    "scoreRange": {
     "low": 82.1,
     "high": 90,
     "point": 87.4
    },
    "computed_at": 1751299200000,
    "description": "Returns a thing.",
    "endpoint_id": 123,
    "serviceName": "Example Thing API",
    "explanations": [
     "High uptime over 144 probes.",
     "Consistent 402 envelope compliance."
    ],
    "flagsDetailed": [],
    "recommendation": "proceed",
    "gradeThresholds": {
     "A": 80,
     "B": 65,
     "C": 50,
     "D": 35,
     "F": 0
    },
    "confidenceDetail": {
     "overall": 0.82,
     "economic": 0.6,
     "observation": 0.9
    },
    "dataCompleteSince": 1748707200000
   },
   {
    "found": false,
    "grade": null,
    "score": null,
    "resource": "https://api.unknown.example/v1/missing",
    "probed_at": null,
    "confidence": null,
    "probes_30d": null,
    "recomputed": fa
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-trust-bulk-score-lookup-347943bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-trust.com](https://www.zero.xyz/host/x402-trust.com/llms.txt)