{"uid":"cap_Dn57XinHyWIqDxtbS9FVZ","slug":"farelight-research-x402-agent-payments-api-06c6c6f1","name":"Farelight Research – x402 Agent Payments 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/payments?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4QyVi1Vvu5thMd5CpG5an","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x3600000000000000000000000000000000000000","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated on-chain x402 payment settlements classified by public versioned rules as agent or non-agent activity on the Arc facilitator","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monitor agent payment volume on Arc","prompt":"Check Farelight for the most recent x402 settlements classified as agent payments on Arc — I want to see the payer and payee addresses, USDC amounts, and how confident the classifier is for each one."},{"title":"Research x402 agent economy trends","prompt":"Pull the last few pages of Farelight payment data for x402 settlements, paginating through with the cursor, and tell me what fraction of transactions are classified as agent vs non-agent activity."},{"title":"Audit specific on-chain settlement","prompt":"Look up the x402 payment settlement for tx hash 0xcafdd317de3b529367c8c3df47273f0d2eb7ff224c4325beee813f189a6fe358 in Farelight and give me its classification, confidence score, block time, and which facilitator processed it."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:31:38.213Z","isFirstParty":false,"canonicalSlug":"farelight-research-x402-agent-payments-api-06c6c6f1"}