# Farelight Research Transaction Lookup

> Farelight Research Transaction Lookup is a paid API for AI agents from farelight.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Fetches classified x402 payment settlement data for a given on-chain transaction hash, including payer/payee labels, classification rules, and gas costs

## Facts

- Endpoint: GET https://farelight.xyz/api/v1/tx/%7Bhash%7D?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farelight-research-transaction-lookup-4f3dee03
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_riB1t7eMDYG-f-wCg-oOY

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-transaction-lookup-4f3dee03
```

Example prompt: Can you look up transaction 0x425d861850aceedd3682ec63bb00502676158f4da11353844d1732cbc87b9fc5 on Farelight and tell me how it was classified — is it a real x402 payment or a test, and who were the payer and payee?

## When to prefer this

Use this endpoint when you need authoritative, rule-based classification of a specific x402 payment transaction — especially when you need to distinguish test payments from production payments with a confidence score and traceable rule rationale. Prefer this over generic blockchain explorers when you need x402-specific labeling, payer/payee entity resolution, and gas cost in USDC rather than raw ETH.

## Known failure modes

- Transaction hash not found on chain returns empty payments array
- Malformed or invalid transaction hash returns an error
- Transaction exists but is not an x402 payment — x402_likely will be false and classification may be low-confidence
- Classification rules may not yet cover novel payment patterns, resulting in lower confidence scores
- Network or RPC latency may cause delayed responses for very recent transactions

## 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 transaction hash, timestamp, and an array of payment records. Each payment includes payer and payee Ethereum addresses with entity labels, USDC amount, gas used and gas cost in USDC, facilitator name, block number and time, x402 likelihood flag, payment classification (e.g. 'test', 'production'), classification confidence score (0–1), and the versioned rules that drove the classification decision.

## 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",
  "tx_hash": "0x425d861850aceedd3682ec63bb00502676158f4da11353844d1732cbc87b9fc5",
  "payments": [
   {
    "payee": "0x2ca647ce44d428b00caceffbbee9eea516e66494",
    "payer": "0x0bc5ffac16bb7f3398b173a061d81920cf3e238b",
    "phase": "public",
    "token": "USDC",
    "amount": "0.001000",
    "method": "transferWithAuthorization",
    "gas_used": 117047,
    "log_index": 15,
    "submitter": "0xa3dfb958c725cba41bc3dd8706eb638872436f5f",
    "batch_size": 1,
    "block_time": "2026-09-23T14:36:10.000Z",
    "facilitator": "circle",
    "payee_label": {
     "entity": "farelight-seed",
     "category": "test"
    },
    "payer_label": {
     "entity": "farelight-test-payer",
     "category": "test"
    },
    "x402_likely": true,
    "block_number": 22362438,
    "payment_type": "transfer",
    "class_reasons": {
     "rules": [
      {
       "rule": "T5",
       "evidence": {
        "label": "test:farelight-seed"
       }
      },
      {
       "rule": "also:A1a"
      }
     ]
    },
    "class_version": "v1.0",
    "gas_cost_usdc": "0.002886603990654538",
    "auth_log_index": 13,
    "classification": "test",
    "class_confidence": 0.99
   }
  ],
  "classification_run": 131,
  "methodology_version": "v1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farelight-research-transaction-lookup-4f3dee03/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)