# Farelight Research - Wallet Payment History

> Farelight Research - Wallet Payment History is a paid API for AI agents from farelight.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Returns paginated on-chain x402 payment history for a given wallet address, with each settlement classified by phase, facilitator, and confidence score using versioned public rules.

## Facts

- Endpoint: GET https://farelight.xyz/api/v1/wallets/%7Baddress%7D/payments?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farelight-research-wallet-payment-history-468882fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ylrily8FR9kX3a8ABtwDZ

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 farelight-research-wallet-payment-history-468882fe
```

Example prompt: Pull up the full x402 payment history for wallet 0x9579e4804fa2216c8e4e49ffd3c495afc6f6971e on Farelight — I want to see each settlement's amount, facilitator, classification, and confidence score.

## When to prefer this

Use this endpoint when you need on-chain x402 payment records for a specific wallet address with human-readable classification metadata (phase, facilitator, confidence). Prefer it over generic blockchain explorers when you need Arc/x402-specific classification by versioned public rules, or when you need structured, paginated output ready for agent consumption. Best when auditing agent spending, researching facilitator usage, or distinguishing test from production settlements.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty dataset
- Wallet with no x402 activity returns an empty data array
- Pagination cursor mismatch or stale cursor may return unexpected results
- Rate limiting or $0.01 USDC payment failure prevents access
- Blockchain indexing lag may cause recent transactions to not yet appear

## How this service works

Agent payments on Arc, measured in the open. Every x402 settlement, read from the chain and classified by public, versioned rules.

## Output

Returns a JSON array of payment records under a `data` key, each with payee, payer, phase, token (e.g. USDC), amount, transaction hash, direction (in/out), log index, submitter, block time, facilitator, x402_likely flag, block number, classification label, class version, and confidence score. Also includes `as_of` timestamp, `next_cursor` for pagination, `classification_run` ID, and `methodology_version`.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "payee": "0x6bf001bb5f5e75396d92163325ca01fdebe2e9a9",
    "payer": "0x9579e4804fa2216c8e4e49ffd3c495afc6f6971e",
    "phase": "public",
    "token": "USDC",
    "amount": "0.011745",
    "tx_hash": "0x981febbb5267182a76b0c558b0adfd9a5960db84451c03f88684dd26cfa62f63",
    "direction": "in",
    "log_index": 48,
    "submitter": "0xe074bf7f0aa27642059e6fcc40688b61d8265b49",
    "block_time": "2026-09-25T17:09:04.000Z",
    "facilitator": "arcus",
    "x402_likely": true,
    "block_number": 22720932,
    "class_version": "v1.0",
    "classification": "test",
    "class_confidence": 0.9
   }
  ],
  "as_of": "2026-09-25T18:42:31.596Z",
  "next_cursor": "MjI3MjA5MzI6NDg",
  "classification_run": 131,
  "methodology_version": "v1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farelight-research-wallet-payment-history-468882fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from farelight.xyz](https://www.zero.xyz/host/farelight.xyz/llms.txt)