{"uid":"cap_IjkcRtqoykfLCTBlDdKgk","slug":"agoranome-machine-payers-endpoint-63c0e57d","name":"Agoranome Machine Payers Endpoint","description":"Who pays my x402 API, and do they come back? Customer analytics for an x402 seller from USDC payments on Base: repeat buyers versus one-off and sweep-like payers, revenue per payer and weekly retention cohorts. Use when an agent needs payer analytics for a pay-to address. Agoranome pledges 15% of settled revenue to a cause, verifiable at /impact/ledger.","url":"https://api.agoranome.com/v1/machine/payers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"days":{"type":"integer","maximum":30,"minimum":1},"address":{"type":"string","description":"Seller pay-to address on Base"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{"summary":{"payers":40,"sweep_like":9,"repeat_buyers":12},"headline":"12 of 40 payers came back; 9 look like sweeps or graders."},"receipt":{"impact":{"pledge":"15% of settled revenue"},"receipt_id":"0x..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5QQONwImtLjF9T-DIcKmK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a breakdown of who has paid a seller's x402 API address on Base, including payer count, repeat buyers, and sweep-like activity, over a configurable time window.","exampleAgentPrompt":"Pull up the payer breakdown for my x402 API at Base address 0xAbC123... over the last 14 days — I want to know how many are repeat buyers versus one-time callers, and whether any look like sweeps or graders.","exampleUseCases":[{"title":"Spot graders gaming my API pricing","prompt":"Check my x402 API address 0xDef456... for the past 7 days — I'm worried some callers are just sweep-testing my endpoint rather than actually using it. How many look like sweeps or graders versus real buyers?"},{"title":"Track repeat buyer loyalty over a month","prompt":"For my paid API at Base address 0xAbc789..., pull the payer stats for the last 30 days and tell me how many of those callers came back more than once — I want to know if I'm building a loyal machine buyer base."},{"title":"Validate demand before relisting","prompt":"Before I relist my x402 endpoint, can you check who's been paying address 0x1A2B3C... over the past 5 days? I just want a quick summary of total payers and whether any are repeat buyers so I know if there's real demand."}],"resultDescription":"A JSON object containing a summary with total payer count, number of sweep-like or grader accounts, and number of repeat buyers, plus a human-readable headline and a receipt object confirming the 15%-of-revenue impact pledge and a receipt ID.","failureModes":["Missing or invalid Base address returns a validation error","Days parameter out of range (1–30) returns a schema error","No payment activity for the address returns zero-count summary","Invalid or unpaid x402 request returns 402 Payment Required","Address with no on-chain payment history returns empty payer set"],"whenToPreferThis":"Use this endpoint when you need on-chain buyer-side analytics for a specific x402 API seller address on Base — specifically to understand payer volume, loyalty (repeats), and quality (sweeps vs genuine buyers) over a rolling time window. Prefer it over generic blockchain explorers when you want pre-computed summaries with grader detection rather than raw transaction lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:37:30.765Z","isFirstParty":false,"canonicalSlug":"agoranome-machine-payers-endpoint-63c0e57d"}