# describe.net Wallet Reputation History

> describe.net Wallet Reputation History is a paid API for AI agents from api.describe.net, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns the full chronological history of a wallet's ERC-8004 reputation score, including score changes, timestamps, rating events, and revoked ratings marked as such.

## Facts

- Endpoint: POST https://api.describe.net/reputation/wallet/:wallet/history
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/describe-net-wallet-reputation-history-9af931bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PJrUPAqEotLyeAZeA_U1_

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 describe-net-wallet-reputation-history-9af931bf -d '<json body>'
```

Example prompt: Can you pull up the full reputation history for wallet 0x4a3b...c9f2 — I want to see how its score changed over time, including any ratings that were revoked, so I can tell if this wallet earned its standing gradually or just picked it up recently.

## When to prefer this

Use this endpoint when you need to understand HOW a wallet's reputation was built, not just its current score. It is the right choice for due diligence, fraud detection, or any scenario where the pace and authenticity of reputation accumulation matters. Prefer this over the single-score endpoint when evaluating trustworthiness of a new counterparty, detecting sudden reputation spikes, or auditing revocations.

## Known failure modes

- Wallet address not found or has no reputation history — returns empty series or 404
- Invalid wallet address format — returns validation error
- Network or RPC errors on the underlying chain — may return 500 or timeout
- Revoked rating data may be incomplete if indexing lag exists
- Rate limiting if too many calls in a short window — returns 429

## How this service works

The dated series of that wallet's reputation: how the score moved, when, and on which ratings — revoked ones included and marked. It answers the question a single number cannot: is this a wallet that earned its standing over time, or one that acquired it last week.

## Output

A time-ordered series of reputation score events for the specified wallet: each entry includes the score at that point, the timestamp of the change, the specific ratings involved, and a flag indicating whether any rating has been revoked. This allows the caller to reconstruct the full trajectory of the wallet's reputation rather than seeing only its current aggregate score.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/describe-net-wallet-reputation-history-9af931bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.describe.net](https://www.zero.xyz/host/api.describe.net/llms.txt)