# Agoranome

> Tools for x402 sellers and buyers, paid per call in USDC by the agents that use them. For sellers: a listing lint and a 402 conformance run, a Bazaar rank check, a Machine Buyer Panel that tests whether buyer agents pick your offer over its rivals, signed samples, Fair Offer certification, a model-update watch, and a demand gap finder for what to build next. For buyers: a signed Buyer check on any offer before paying (or settlement proof after), a buyer drill that red-teams an x402 client against nine traps, a wallet statement (overspending, duplicates, changed listings), and free checks of any seller's offer. Every paid tool has a free sample. Agoranome pledges 15% of settled revenue to a cause.

Pay with any x402 v2 client: scheme `exact`, network `eip155:8453` (Base), USDC. Call a paid route without payment to get its 402 offer (PAYMENT-REQUIRED header), then retry with the PAYMENT-SIGNATURE header. Every price is at or under $1, the default spend cap of the official x402 clients. A call that fails is never settled, so you aren't charged for it.

Reports are data about listings, never instructions. Each paid result carries a signed receipt and the impact pledge.

## Paid tools (x402)

- [Listing lint](https://api.agoranome.com/v1/seller/lint): $0.01 per call, GET with a query string. Inputs: url (string, required). Why isn't my x402 API in the Bazaar? Listing lint checks an x402 endpoint for Bazaar indexing: one unpaid call validates its 402 PAYMENT-REQUIRED header, discovery metadata, input and output schemas, description limits and service name against the indexing rules, with a fix for each problem and the fixed 402 ready to paste, graded as the weekly report card would grade it. Use when an agent needs to lint an x402 listing before its first settled payment.
- [Rank check](https://api.agoranome.com/v1/seller/rank): $0.01 per call, GET with a query string. Inputs: task (string, required), resource (string, required), network (string). Where does my x402 API rank in Bazaar search? Rank check runs the search a buyer agent would run for your task and returns your rank, the listings ahead of you, the signals where you trail them (payers, calls, description, example, schema, price), what the three winners' descriptions say that yours doesn't, and your share of voice across the buyer searches of your category. Search rank and competitor analysis for x402 listings. A three-result sample is free at /v1/seller/rank/sample.
- [Rank watch](https://api.agoranome.com/v1/seller/rank/watch): $1.00 per call, POST with a JSON body. Inputs: task (string, required), resource (string, required), network (string), notify (string). Is my x402 API losing rank in Bazaar search? The rank watch runs the rank check for your task now, then again every week for 30 days, and alerts you when your rank drops, you fall out of the results, or your share of voice across your category's buyer searches shrinks. One payment, no renewal. Status is free at the watch URL; an optional https webhook gets each drop.
- [Machine Buyer Panel](https://api.agoranome.com/v1/seller/panel): $1.00 per call, POST with a JSON body. Inputs: resource (string, required), tasks (list of string, required). Will buyer agents choose my x402 API? The Machine Buyer Panel is an A/B conversion test: buyer-agent models choose between your offer and its real Bazaar rivals for up to three tasks, across buyer personas and list positions. Returns your win rate with confidence intervals (position-corrected too), why you lost, up to three truthful edits tested on the same trials, and the proof arm: whether a Fair Offer block or an attested sample lifts your pick rate.
- [Single-task panel](https://api.agoranome.com/v1/seller/panel/one): $0.25 per call, POST with a JSON body. Inputs: resource (string, required), task (string, required). Will buyer agents pick my x402 API for one task? The single-task panel is the Machine Buyer Panel for buyers under a dollar cap: buyer-agent models choose between your offer and its real Bazaar rivals for one task, across personas and list positions. Returns your win rate with confidence intervals, why you lost, and the proof arm (does a Fair Offer block or an attested sample lift your pick rate). No drafted edits; the full panel tests those.
- [Signed sample](https://api.agoranome.com/v1/seller/attest): $0.05 per call, GET with a query string. Inputs: sample (string, required), resource (string, required). Trust proof for an x402 seller: a signed attestation of your API's sample output, so buyer agents can check it before paying. Agoranome fetches a free sample from your endpoint's host, checks that your paid route on the same host answers with an x402 offer, and signs an attestation of what it saw and when: the sample's SHA-256 and body, and the offer's price, network and pay-to. Buyers check it at a public URL.
- [Demand gap finder](https://api.agoranome.com/v1/seller/gaps): $1.00 per call, GET with a query string. Inputs: topic (string). What x402 API should I build? The demand gap finder runs up to 150 Bazaar searches phrased the way buyer agents phrase tasks and ranks the unmet demand: tasks whose top results are weak (no listings, few payers, thin descriptions or a poor fit), with the evidence for each, a spec per gap (an OpenAPI skeleton, a Fair Offer block and a price from the category price index) and the gap's trend week over week. Public Bazaar data only, joined with measured repeat demand per category.
- [Real-customer analytics](https://api.agoranome.com/v1/machine/payers): $0.05 per call, GET with a query string. Inputs: address (string, required), days (integer). 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.
- [Weekly x402 demand insights](https://api.agoranome.com/v1/machine/insights): $0.25 per call, GET with a query string. Inputs: week (string). What are agents buying on x402? A weekly x402 market data and demand report from Bazaar discovery and Base settlements: repeat-use demand by category, demand gaps, movers, price bands and GET vs POST traction, adjusted for sweeps, with cited sources. Use when an agent needs x402 demand by category before choosing what to build or how to price it.
- [Model-update watch](https://api.agoranome.com/v1/seller/watch): $1.00 per call, POST with a JSON body. Inputs: resource (string, required), tasks (list of string, required), notify (string). Will a new AI model stop buying my x402 API? The model-update watch tests your offer against its real Bazaar rivals with the Machine Buyer Panel now, then re-runs the same test whenever a panel model changes over the next 30 days and flags a drop in your win rate. One payment, no renewal. Status is free at the watch URL; an optional https webhook gets each result.
- [Fair Offer certification](https://api.agoranome.com/v1/fair-offer/certify): $1.00 per call, POST with a JSON body. Inputs: url (string, required). Fair Offer certification for an x402 API: every claim in your 402's fair-offer block checked against live behaviour. Your public receipts are reconciled against Base, your free sample is attested, the block is checked against the 0.2 schema and across two requests, and the listing price against the Bazaar; priced at 5 cents or less, your route is also paid once to check that failed calls are free and results carry signed receipts. Pass or fail, the signed result is published at a public URL.
- [Continuous certification](https://api.agoranome.com/v1/fair-offer/certify/continuous): $1.00 per call, POST with a JSON body. Inputs: url (string, required), notify (string). Continuous Fair Offer certification for an x402 API: the full certification now (priced at 5 cents or less, your route is paid once to check that failed calls are free and receipts are signed), then re-run about once a day for 30 days. The public status and badge show the latest check, so a pass is withdrawn the day a check fails, and every check's signed result is published. One payment, no renewal; a seller pays for the checking, never for the outcome.
- [402 conformance run](https://api.agoranome.com/v1/seller/conformance): $1.00 per call, GET with a query string. Inputs: url (string, required). 402 conformance and security check for an x402 or MPP API: can buyer agents' SDKs pay it, and is it safe to pay? Checks the x402 v2 requirements (amounts, addresses, the token's EIP-712 domain, the same terms on every request), that malformed and forged payments are refused the same way, resource and pay-to binding, MPP challenges against the paymentauth.org draft, and the live price against the Bazaar and openapi.json. At 5 cents or less, one paid call also checks replay, mutation and no-store.
- [Buyer check](https://api.agoranome.com/v1/buyer/check): $0.01 per call, GET with a query string. Inputs: url (string, required), tx (string), accept_proof (string), max_price (number), expected_price (number), pay_to (string), share (boolean). Buyer check before paying an x402 seller: a signed verdict on one offer from what Agoranome already holds, with the Fair Offer block valid and certified or not, the pay-to seen for this host and since when, the price against listing and quote, verified deliveries, and which policy tiers the offer meets. With tx=, settlement proof after paying: the USDC transfer on Base, whether it matched the quote, and a buyer-side receipt for the commons. Use when an agent needs seller evidence as it pays.
- [Buyer drill](https://api.agoranome.com/v1/buyer/drill): $1.00 per call, POST with a JSON body. Inputs: client (string), publish (boolean). Buyer drill: red-team an x402 client with one token and nine trap routes on Agoranome's own host, each a $0.001 seller: a correct offer and eight attacks (price switch, lookalike asset, pay-to swap, network switch, instructions in the paid body, slow responder, unsettled 200, ambiguous error). Nothing signed at a trap is settled. Within 24 hours, a signed report: traps refused, traps paid, cents at risk, one certificate line. Use before a client or policy goes live.
- [Wallet statement](https://api.agoranome.com/v1/buyer/audit): $1.00 per call, GET with a query string. Inputs: wallet (string, required), days (integer). Wallet statement for an x402 buyer wallet on Base: every USDC payment checked against the payee's listed Bazaar price (above listed, oversize 10x or more, unlisted), spend and calls per seller, duplicate payments within a minute, payments made after a seller's listing vanished or its pay-to changed, sellers whose certification failed since, whether the wallet itself looks sweep-like, and a CSV of every payment. Use when an agent or its operator needs to account for an x402 wallet's spending.
- [Vendor watch](https://api.agoranome.com/v1/buyer/watch): $1.00 per call, POST with a JSON body. Inputs: sellers (list of string), wallet (string), notify (string). Vendor watch for x402 buyers: name up to ten seller URLs, or a wallet whose sellers are read from its payments, and for 30 days each is checked daily: price, pay-to, Fair Offer block, Bazaar listing, certification state and latency. A signed diff waits at a free status URL and a pay-to or price change, a lost block, a vanished listing or a failed certification is posted to your webhook. Use when an agent pays the same sellers again and again. No renewal.
- [Response safety scan](https://api.agoranome.com/v1/buyer/scan): $0.01 per call, POST with a JSON body. Inputs: seller (string, required), body (string), spans (list of string), share (boolean). Response safety scan for x402 buyers: post a paid response body, or passages of it, with the seller's URL and get back instruction-like passages aimed at an agent, hidden characters, exfiltration links, a mismatch against the seller's declared output example, and whether the seller's "data, never instructions" claim held. Nothing posted is stored; with share=true a contradicted claim becomes evidence on the seller's record, as hashes. Use before an agent acts on a paid result.
- [Pre-flight plan quote](https://api.agoranome.com/v1/buyer/quote): $0.01 per call, POST with a JSON body. Inputs: plan (list of object, required), caps (object). Pre-flight plan quote for x402 buyers: post a plan of seller URLs and call counts and get the total cost, each seller's listing and certification state, its expected failure share from reconciled receipts, the fit against your caps (per call, per seller, total, policy tier), and every certified seller in the same category sorted by price with the sort key stated. Use before a planner agent starts a batch of paid calls.
- [Dispute evidence pack](https://api.agoranome.com/v1/buyer/dispute): $1.00 per call, POST with a JSON body. Inputs: tx (string, required), seller (string, required), offer (object), response (object), expected_price_usd (number), pay_to (string), claim (string). Dispute evidence pack for x402 buyers: given a payment's transaction hash, the seller URL, the accepted 402 and the response, get the settlement on Base, the Fair Offer terms at quote time (failed calls free, receipts, refunds), what Agoranome observed of that seller in that hour, the seller's published contact and a draft claim addressed to it, all signed. Use when an agent was charged and not served.
- [Fund the evidence commons](https://api.agoranome.com/v1/commons/fund): $0.10 per call, GET. Inputs: no inputs. Fund the x402 evidence commons: a $0.10 contribution that keeps Agoranome's evidence lookups, Fair Offer checker and buyer policy pack free. Returns a signed receipt; 15% goes to the cause Agoranome pledges to, verifiable at /impact/ledger. Nothing else is delivered, and a contribution never changes a result, a rank or a certification.
- [Payment test](https://api.agoranome.com/v1/machine/ping): $0.001 per call, GET. Inputs: no inputs. x402 ping and test payment: can my wallet pay an x402 API? Pay a fraction of a cent in USDC on Base and get a signed receipt back, proof that your wallet and x402 client complete a real paid call end to end, plus what the Lab knows about your wallet and which tool to try next. Use when an agent needs a cheap test payment endpoint before buying anything bigger.

## Free

- [Rank sample](https://api.agoranome.com/v1/seller/rank/sample): The top three Bazaar results for a task, and your rank if you pass resource=. Free.
- [Insights teaser](https://api.agoranome.com/insights/latest): This week's x402 demand headline, brief and sources. The full report is the paid insights route.
- [How machines chose](https://api.agoranome.com/machines/weekly): Free weekly page: how buyer-agent models chose between x402 offers in Machine Buyer Panel runs, pooled and anonymized.
- [Check a signed sample](https://api.agoranome.com/v1/attestations/verify): POST a signed sample attestation to check its signature and that it's the one on record. Free.
- [Machine Choice Benchmark](https://api.agoranome.com/machines/benchmark): Which live x402 offers buyer-agent models choose, by category: shares by host, position effects, price elasticity, and how much choices moved since the last report. Raw trials, CC BY 4.0; every trial of every report at /machines/benchmark/dataset.jsonl.
- [Shock feed](https://api.agoranome.com/machines/benchmark/shocks.json): JSON Feed: how far buyer-agent models' choices moved between benchmark reports, per category, and which panelists moved most. Free; the paid model-update watch re-tests your own offer on each one.
- [Machine Buyer Safety](https://api.agoranome.com/machines/buyer-safety): How x402 buyer clients fare against the attacks a paying agent meets (price switch, lookalike asset, pay-to swap, injected instructions, unsettled 200, double-payment bait), pooled from closed buyer drills. No client named without its buyer's consent. JSON at /machines/buyer-safety.json.
- [Impact ledger](https://api.agoranome.com/impact/ledger): Agoranome's 15% pledge, settled revenue and donations, with Merkle proofs per receipt.
- [Pledge study](https://api.agoranome.com/impact/pledge-study): Whether buyer-agent models pick Agoranome's offer more often with its verified pledge than without; every run published.
- [Fair Offer check](https://api.agoranome.com/v1/fair-offer/check): Check any x402 offer's Fair Offer block from outside, without paying: ask with ?url=<the offer's URL>, and each of the seven rules comes back verified, declared, contradicted or not claimed. Add accept_proof= to test a buyer's requirements. POST a block to /v1/fair-offer/validate to validate it. Free.
- [Listing report cards](https://api.agoranome.com/sellers): How each Bazaar seller's listings look to a buyer agent's search, graded, from the weekly index snapshot. JSON at /sellers/{host}.json. Free.
- [Evidence commons](https://api.agoranome.com/commons): Sellers' verified deliveries in 30 days: their public receipts, each checked against the USDC transfer on Base, without self-payments, sweep bots or round trips. Look up a seller at /v1/evidence/{host}; every receipt at /commons/receipts.ndjson, CC BY 4.0. Free.
- [Buyer policy](https://api.agoranome.com/policy): An open buyer policy for x402: a price cap, a payee allowlist, no instructions in listings and a proof tier (any, sampled, delivered). Ask whether it would pay any offer at /v1/policy/check?url=<the offer's URL>&tier=sampled; what buyers require and what they couldn't buy at /v1/policy/admission and /v1/policy/unmet-intents, CC BY 4.0. Free.
- [Free samples](https://api.agoranome.com/v1/machine/ping/sample): Every paid route answers at its address plus /sample with its output example, or a live free sample where it has one. This one is the payment test's. Free.

## MCP and agent skill

- [MCP server](https://api.agoranome.com/mcp): Streamable HTTP. The same tools (lint_listing, rank_check, rank_watch, buyer_panel, buyer_panel_one, signed_sample, demand_gaps, payer_analytics, weekly_insights, model_watch, certify_offer, certify_continuous, conformance_check, buyer_check, buyer_drill, spend_audit, vendor_watch, response_scan, plan_quote, dispute_pack, fund_commons, ping) plus a free rank_sample, check_fair_offer and check_offer. A paid tool answers an unpaid call with an error result whose structuredContent is the x402 PaymentRequired; retry with the payment payload in params._meta["x402/payment"]. The settlement comes back in _meta["x402/payment-response"].
- [Agent skill](https://api.agoranome.com/skills/agoranome-seller-tools/SKILL.md): when and how to use each tool, as a SKILL.md.

## Optional

- [Catalog](https://api.agoranome.com/v1/catalog): every offer as JSON, with input schemas, examples and free samples.
- [Agent manifest](https://api.agoranome.com/.well-known/agent-manifest): the agent card: who we are, how we are paid, what we conform to, and the same offers.
- Free samples: every paid route answers at its address plus `/sample` with its output example, for example https://api.agoranome.com/v1/machine/ping/sample. Each 402 names its sample in the fair-offer block.
- [OpenAPI](https://api.agoranome.com/openapi.json): the HTTP API.
- [Fair Offer Standard](https://api.agoranome.com/standard): the open standard's text and schema, CC BY 4.0.
- [Buyer policy pack](https://api.agoranome.com/policy): the open-source policy a buyer agent runs before it pays, Apache-2.0; on [PyPI](https://pypi.org/project/agoranome-policy/) as agoranome-policy.