# Farelight Research Wallet Profile API

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

Looks up on-chain x402 payment activity and classification for a given wallet address on the Arc network

## Facts

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

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-profile-api-78505393
```

Example prompt: Can you pull up the Farelight profile for wallet 0x6bf001bb5f5e75396d92163325ca01fdebe2e9a9 and tell me how it's classified — is it an agent, a service, or something else — and how many x402 settlements it's made?

## When to prefer this

Use this endpoint when you need on-chain, verifiably sourced data about x402 payment activity specifically on the Arc network, with transparent classification methodology. Prefer it over generic blockchain explorers when you need agent-specific classifications (agent vs. service vs. test), facilitator attribution, and versioned classification rules rather than raw transaction data.

## Known failure modes

- Wallet address not found — returns empty or null profile if address has no recorded x402 activity
- Invalid address format — malformed Ethereum address may return an error
- No payer or payee data — wallet may exist but have zero settlements recorded
- Stale data — classification run may lag behind the most recent on-chain activity
- Rate limiting — exceeding call quota at $0.01/call may result in 402 or 429 responses

## 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 object with the wallet address, a human-readable entity label with evidence URL, payment statistics as both payer and payee (broken down by classification rule, volume, payment count, and counterparties), the relayer and facilitator chain used, first and last seen timestamps, first funding transaction details, and the methodology version used for classification.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-09-25T18:42:31.596Z",
  "label": {
   "entity": "arcrouter",
   "source": "observed",
   "category": "service",
   "evidence": "https://arcrouter.co/.well-known/x402 ; tx 0xb7cc456ae0d0bc4cb3689547f7d811fde8bad1a56facd75652d3897fd00056a3 (first inbound settlement, 2026-09-21)"
  },
  "address": "0x6bf001bb5f5e75396d92163325ca01fdebe2e9a9",
  "gateway": null,
  "as_payee": {
   "rules": [
    {
     "rule": "T3",
     "count": 608
    },
    {
     "rule": "A1b",
     "count": 9
    }
   ],
   "relayers": [
    {
     "count": 617,
     "relayer": "0xe074bf7f0aa27642059e6fcc40688b61d8265b49",
     "facilitator": "arcus"
    }
   ],
   "counterparties": 5,
   "by_classification": [
    {
     "volume": "9.954754",
     "payments": 608,
     "classification": "test"
    },
    {
     "volume": "27.000908",
     "payments": 9,
     "classification": "agent"
    }
   ]
  },
  "as_payer": {
   "rules": [],
   "relayers": [],
   "counterparties": 0,
   "by_classification": []
  },
  "last_seen": "2026-09-25T17:09:04.000Z",
  "first_seen": "2026-09-21T12:31:33.000Z",
  "first_funding": {
   "from": "0x8b1b2f3fb35f45e96c4e81ec9ea7aa955c584193",
   "amount": "1.000000",
   "tx_hash": "0xb7cc456ae0d0bc4cb3689547f7d811fde8bad1a56facd75652d3897fd00056a3",
   "was_a_payment": true
  },
  "classification_run": 131,
  "methodology_version": "v1.0",
  "classification_as_payer": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farelight-research-wallet-profile-api-78505393/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)