# Settled — Seller Reputation by PayTo Address

> Settled — Seller Reputation by PayTo Address is a paid API for AI agents from settled.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Returns on-chain settlement statistics and liveness data for an x402 seller identified by their payTo wallet address

## Facts

- Endpoint: GET https://settled.tools/v1/payto/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/settled-seller-reputation-by-payto-address-706e1eb6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MnKGxSyqAhkSf5YN1rGlH

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 settled-seller-reputation-by-payto-address-706e1eb6
```

Example prompt: Before I let my agent pay that x402 endpoint, can you pull up the seller reputation for payTo address 0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea — I want to see how many settlements they've had in the last 30 days and whether there are any flags?

## When to prefer this

Use this endpoint when you need historical on-chain reputation data for a specific payTo wallet address — e.g. to vet a seller before an agent autonomously pays an x402 endpoint. Prefer this over the liveness/quote check endpoint when you care about settlement history, payer diversity, and flagging rather than real-time endpoint availability.

## Known failure modes

- Address not found or never seen — returns empty or null stats
- Invalid address format returns a 400 or validation error
- Address has no on-chain settlements — returns zeroed stats
- Network unavailable for Base — onchain array may be empty
- Rate limit exceeded if called excessively without day pass

## How this service works

Settled probes every x402 endpoint, buys from them with real USDC on Base and checks what comes back against the listing, and follows who really pays each seller. Free checks, signed answers.

## Output

A signed JSON object containing: number of live endpoints served by this address, total settlements in the last 30 days, unique payers in the last 30 days, last settlement timestamp, price range in USD, date first seen, onchain network-level breakdowns (network, status, coverage window), and any flags raised by Settled's probing system.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "live": 11,
  "flags": [],
  "address": "0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea",
  "onchain": [
   {
    "status": "ok",
    "window": {
     "days": 30,
     "coverage_from": "2026-08-26T14:02:00.000Z"
    },
    "network": "eip155:8453",
    "settlements_30d": 1840,
    "unique_payers_30d": 63,
    "last_settlement_at": "2026-09-25T14:02:00.000Z"
   }
  ],
  "endpoints": 12,
  "first_seen": "2026-09-01T00:00:00.000Z",
  "price_range_usd": [
   0.001,
   0.05
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/settled-seller-reputation-by-payto-address-706e1eb6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from settled.tools](https://www.zero.xyz/host/settled.tools/llms.txt)