{"uid":"cap_wnl28DiUTOvDXf7ADcBA4","slug":"farelight-research-wallet-profile-api-78505393","name":"Farelight Research Wallet Profile API","description":"Agent payments on Arc, measured in the open. Every x402 settlement, read from the chain and classified by public, versioned rules.","url":"https://farelight.xyz/api/v1/wallets/%7Baddress%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZCjCSW6bKe5TopdaiuZVZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x3600000000000000000000000000000000000000","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up on-chain x402 payment activity and classification for a given wallet address on the Arc network","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Audit an unknown agent's payment history","prompt":"I found this wallet address 0xabc123... showing up in our x402 logs — can you look it up on Farelight and tell me what entity it is, whether it's classified as an agent or a service, and how much volume it's processed?"},{"title":"Verify a counterparty before integrating","prompt":"Before we whitelist this wallet 0xdef456... as a trusted payee in our system, can you check Farelight to see how long it's been active, which facilitators it uses, and how it's classified on the Arc network?"},{"title":"Research Arc network agent activity","prompt":"I want to understand the activity of wallet 0x6bf001bb5f5e75396d92163325ca01fdebe2e9a9 on Arc — pull up its Farelight profile and show me its payment breakdown by classification, the relayers involved, and when it first appeared on-chain."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T18:38:13.989Z","isFirstParty":false,"canonicalSlug":"farelight-research-wallet-profile-api-78505393"}