# Farelight Research – x402 Agent Payments API

> Farelight Research – x402 Agent Payments API is a paid API for AI agents from farelight.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-17).

Returns paginated on-chain x402 payment settlements classified by public versioned rules as agent or non-agent activity on the Arc facilitator

## Facts

- Endpoint: GET https://farelight.xyz/api/v1/payments?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farelight-research-x402-agent-payments-api-06c6c6f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dn57XinHyWIqDxtbS9FVZ

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-x402-agent-payments-api-06c6c6f1
```

Example prompt: Pull the latest batch of x402 payment settlements from Farelight that are classified as agent activity on the Arc facilitator, including their confidence scores and methodology version, and show me the most recent ones first.

## When to prefer this

Choose this endpoint when you need structured, versioned, publicly auditable classifications of x402 on-chain payments specifically on the Arc facilitator. It is ideal for agent economy research, monitoring AI agent spending patterns, or auditing individual settlements against a published classification methodology. Prefer it over raw blockchain RPCs when you want pre-classified, human-readable payment records with confidence scores and pagination support.

## Known failure modes

- Invalid or expired cursor returns empty results or 400 error
- Unknown facilitator filter yields empty data array
- Rate limiting or upstream chain indexing lag may cause stale as_of timestamps
- Malformed query parameters return 400 bad request
- Low classification confidence scores (e.g. 0.65) may indicate ambiguous transactions not reliably attributable to agents

## 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

A JSON object containing a paginated list of x402 payment records, each with payee and payer addresses, USDC amount, transaction hash, log index, block number and timestamp, facilitator name, a boolean x402_likely flag, a classification label (e.g. 'agent'), a confidence score (0–1), and the class_version used. The envelope also includes an as_of timestamp, a next_cursor for pagination, and the current classification_run and methodology_version identifiers.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "payee": "0x429dfa4010511d0d4ed43e7f90ab07fa5533bcea",
    "payer": "0xeb8a2bc314d7b911f2f075f266b75ef316943726",
    "phase": "public",
    "token": "USDC",
    "amount": "0.500000",
    "tx_hash": "0xcafdd317de3b529367c8c3df47273f0d2eb7ff224c4325beee813f189a6fe358",
    "log_index": 27,
    "submitter": "0xe074bf7f0aa27642059e6fcc40688b61d8265b49",
    "block_time": "2026-09-25T18:19:15.000Z",
    "facilitator": "arcus",
    "x402_likely": true,
    "block_number": 22729226,
    "class_version": "v1.0",
    "classification": "agent",
    "class_confidence": 0.65
   }
  ],
  "as_of": "2026-09-25T18:42:31.596Z",
  "next_cursor": "MjI3MjkyMjY6Mjc",
  "classification_run": 131,
  "methodology_version": "v1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farelight-research-x402-agent-payments-api-06c6c6f1/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)