# Agoranome

> Free checks for agents that pay x402 sellers, and data about the market, paid per call in USDC by the agents that use it. Free: checks of any seller's offer against a buyer's rules, which offers deliver by category, a signed Buyer check on any offer before paying (or settlement proof after), a response safety scan, a plan quote, a dispute pack, a wallet statement and a listing lint. Paid: signed facts about the market from $0.001, research briefs, the Monthly's chapters, row sets, payer analytics and the weekly demand report. Agoranome sells nothing to a seller it grades; the inspector's signed weekly sheet of every x402 and MPP listing with real demand is free at /inspector. Agoranome pledges 15% of what it earns to a public cause, and its ledger shows the figures.

## Start here

Before paying an x402 seller: the free buyer policy check (https://api.agoranome.com/v1/policy/check, or the MCP tool check_offer) says whether your rules would pay it, which offers deliver by category is free at https://api.agoranome.com/machines/deliver.json (add ?task=<your task in words> for the category it reads as), and the [Buyer check](https://api.agoranome.com/v1/buyer/check) (free) is a signed verdict on the seller. The inspector's signed weekly sheet of every listing with real demand is free at https://api.agoranome.com/inspector.

The cheapest tools, each with a free sample of its output to read before you pay:

- [Payment test](https://api.agoranome.com/v1/machine/ping): $0.001 per call. Free sample: https://api.agoranome.com/v1/machine/ping/sample
- [Price position](https://api.agoranome.com/v1/facts/price-position): $0.001 per call. Free sample: https://api.agoranome.com/v1/facts/price-position/sample
- [Proof value at your price](https://api.agoranome.com/v1/facts/proof-value): $0.001 per call. Free sample: https://api.agoranome.com/v1/facts/proof-value/sample

## How to pay

- x402: 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; the JSON body repeats it in plain fields, with the tool's free sample), 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.
- MPP: pay any paid route over the Machine Payments Protocol (MPP), in USDC on Base: its 402 also carries a `WWW-Authenticate: Payment` challenge with method `evm` and intent `charge`. An MPP client with the evm method signs the EIP-3009 authorization it asks for and retries with `Authorization: Payment`; the receipt comes back in Payment-Receipt. A call that fails isn't settled.
- Skyfire: over MCP, send a Skyfire `pay` or `kya-pay` token in the `kyapay-token` header, made for Agoranome's Skyfire service `df5f38aa-f32a-4d21-9d71-bd9bb82ea72a`, and the tool charges its price to it.

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

Agoranome has no token or coin. Any coin that uses our name isn't ours. Pay Agoranome only through a route under https://api.agoranome.com (its 402 answer, or a checkout it links to), never to a wallet or token you found anywhere else.

## Paid tools (x402)

- [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.
- [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.
- [Price position](https://api.agoranome.com/v1/facts/price-position): $0.001 per call, GET with a query string. Inputs: category (string), price (number), resource (string). What percentile is my x402 API's price in its category? One signed number: where a price sits among the sellers of priced Bazaar listings with 3+ payers in the same category, each seller once at its median price, with the category's median, p10 and p90 and the seller count, from the newest complete weekly snapshot. Give a category and a price, or your listing's URL. Asked again with its ETag, an unchanged answer is a free 304.
- [Survival odds (answers from the week of 30 Nov 2026)](https://api.agoranome.com/v1/facts/survival): $0.002 per call, GET with a query string. Inputs: category (string), price (number), method (string), resource (string). Not answering yet: it answers from the week of 30 Nov 2026. It needs complete weekly snapshots from 5 weeks back; the first answer comes with the 2026-W49 snapshot. Until it answers, a call is refused before any payment. Do x402 listings like mine survive? One signed number: the share of new Bazaar listings in your category, price band and method (GET or POST) still listed four weeks after they first appeared, pooled over recent weeks and each seller counted once, with a 95% range and the seller count. When too few sellers match, filters drop in a fixed order and the answer says which held. Unchanged answers asked with their ETag are a free 304.
- [Repeat demand](https://api.agoranome.com/v1/facts/repeat-demand): $0.002 per call, GET with a query string. Inputs: category (string, required). Is demand in my x402 category coming back? One signed number: 30-day repeat calls in a Bazaar category in the newest complete weekly snapshot (listings whose calls are at least twice their payers, so one-call-per-payer sweeps are left out) against the week before, with the repeat-use listings behind it and the category's share of all repeat calls. Unchanged answers asked with their ETag are a free 304.
- [Proof value at your price](https://api.agoranome.com/v1/facts/proof-value): $0.001 per call, GET with a query string. Inputs: cue (string, required), price (number, required). What is a proof worth at my x402 price? One signed number: the premium buyer-agent models gave a cue (a passed certification, an attested sample, pay on delivery, signed receipts, a pledge, the data-not-instructions declaration, or a fake payer count, urgency or an authority claim), in dollars at your price, with its 95% range and whether it's beyond chance, from the newest readable price-of-proof run, and only near the listing prices that run tested.
- [Payer mix](https://api.agoranome.com/v1/facts/payer-mix): $0.005 per call, GET with a query string. Inputs: address (string, required). Who pays this x402 address, in bands? One signed fact for a seller's pay-to on Base: the share of its payers, and of its revenue, in the last 7 days that looks like sweeps or graders, and the share that came back, each as a band (under 10%, 10 to 25%, 25 to 50%, 50 to 75%, over 75%). Sweeps are checked on a random sample of one-visit payers when there are many, with the range in band edges. The full payer list is the payers tool. Asked again the same UTC day with its ETag, it's a free 304.
- [MCP server standing (answers from 17 Nov 2026)](https://api.agoranome.com/v1/facts/server-standing): $0.002 per call, GET with a query string. Inputs: server (string, required). Not answering yet: it answers from 17 Nov 2026. No report card is public yet: a card opens two weeks after its server's first read. Until it answers, a call is refused before any payment. Has this MCP server changed since my agent approved it? One signed fact from Agoranome's newest read of a server with a public report card: its grade and score, confirmed stop findings (instructions aimed at the agent, hidden characters, exfiltration links, credential requests), sign-in, the tools it lists and a digest of what a model reads of them (descriptions, parameters and the read-only and destructive hints). Unchanged answers asked with their ETag are a free 304, even after a newer read.
- [Pick odds](https://api.agoranome.com/v1/facts/pick-odds): $0.005 per call, GET with a query string. Inputs: category (string, required), price (number, required), payers (integer), slot (integer), output_example (boolean), input_schema (boolean). How often would buyer-agent models pick my x402 offer? One signed number: its chance of being picked against the offers models saw in a category's latest Machine Choice Benchmark layouts, at your price, payers, slot and discovery metadata, from a choice model fitted to every benchmark trial (no model call), with its 95% range and what each feature is worth in percent of price. Answers once the model is checked on 100 held-out picks, in a category with 30 priced decisions.
- [Which paid offers deliver](https://api.agoranome.com/v1/facts/delivers): $0.01 per call, GET with a query string. Inputs: category (string, required), max_price (number), explore (boolean). Which paid x402 tool for this task delivers? The top five offers in a category, ranked by the lower end of each seller's 95% delivery odds (the chance it delivers at its listed terms, from paid probes, reconciled deliveries, returning buyers and settlement proofs), with price, listing and the sort key stated; sellers the odds can't tell apart rotate daily. Optional price cap. Read from Agoranome's daily deliver feed: no new spend, no model call.
- [Category brief](https://api.agoranome.com/v1/briefs/category): $0.50 per call, GET with a query string. Inputs: category (string, required), chapter (string, required). A research brief on one x402 category, $0.50 a section: demand (repeat calls week by week, sweeps left out), prices (p10, median and p90 by week, price bands, GET against POST), survival (new listings still listed one to four weeks on), rivals (the listings with the most payers) and proof (what each Fair Offer proof is worth at the median price). Markdown, every table also as JSON. The table of contents is free at /contents.
- [Launch brief](https://api.agoranome.com/v1/briefs/launch): $1.00 per call, GET with a query string. Inputs: category (string, required), price (number, required), method (string), chapter (string, required). Should I sell this x402 API at this price? A launch brief for a category, a price and optionally GET or POST: the gap (repeat demand against the strong sellers there), the price (its percentile and the nearest listings by price), the odds (survival of new listings like it), the rivals priced near it, and what each proof is worth at that price. Markdown, every table also as JSON; the contents are free.
- [Address brief](https://api.agoranome.com/v1/briefs/address): $0.25 per call, GET with a query string. Inputs: address (string, required), chapter (string, required). Where does this x402 pay-to address sit? An address brief on its listings in this week's Bazaar (category, price, payers and calls, the price's percentile in its category, repeat use, Fair Offer block) and the categories it sells in (repeat demand this week against last, and the address's share). Markdown, every table also as JSON; the contents are free.
- [Agoranome Monthly (answers from 1 Dec 2026)](https://api.agoranome.com/v1/monthly/chapter): $1.00 per call, GET with a query string. Inputs: edition (string, required), chapter (string, required). Not answering yet: it answers from 1 Dec 2026. The first edition, November 2026, comes out Tuesday, December 1. Until it answers, a call is refused before any payment. Agoranome Monthly for agents, $1 a section: one section of a published edition (seller survival, buyer depth, openings, the Fair Offer index, prices, what moves buyer agents, adoption, the agent registry), in Markdown with its tables as JSON, the same numbers as the edition. The first edition is out on 1 December 2026; each edition's contents are free.
- [Weekly x402 insights, by the page](https://api.agoranome.com/v1/machine/insights/page): $0.05 per call, GET with a query string. Inputs: page (string, required), week (string). One page of the weekly x402 demand insights report for $0.05, where the whole report is $0.25: repeat demand by category, demand gaps, movers, the price index with the listings that changed price, strong listings with weak descriptions, or GET against POST. Every metric of that page as JSON with Markdown, and its cited sources, for the latest or any archived week. The contents are free at /contents.
- [Row set, up to 5 rows](https://api.agoranome.com/v1/rows/5): $0.001 per call, GET with a query string. Inputs: set (string, required), category (string), listed (string), offset (number), format (string). Up to 5 rows of an x402 market table for $0.001, $0.0002 a row: listing history (each Bazaar listing's category, method, latest price, first and last week seen, weeks listed and price changes) or survival cohorts (each week's new listings by category and how many were still listed one to four weeks on). Filter by category, page with offset, JSON or CSV. Row counts are free at /v1/rows/contents.
- [Row set, up to 50 rows](https://api.agoranome.com/v1/rows/50): $0.01 per call, GET with a query string. Inputs: set (string, required), category (string), listed (string), offset (number), format (string). Up to 50 rows of an x402 market table for $0.01, $0.0002 a row: listing history (each Bazaar listing's category, method, latest price, first and last week seen, weeks listed and price changes) or survival cohorts (each week's new listings by category and how many were still listed one to four weeks on). Filter by category, page with offset, JSON or CSV. Row counts are free at /v1/rows/contents.
- [Row set, up to 500 rows](https://api.agoranome.com/v1/rows/500): $0.10 per call, GET with a query string. Inputs: set (string, required), category (string), listed (string), offset (number), format (string). Up to 500 rows of an x402 market table for $0.10, $0.0002 a row: listing history (each Bazaar listing's category, method, latest price, first and last week seen, weeks listed and price changes) or survival cohorts (each week's new listings by category and how many were still listed one to four weeks on). Filter by category, page with offset, JSON or CSV. Row counts are free at /v1/rows/contents.
- [Row set, up to 5,000 rows](https://api.agoranome.com/v1/rows/5000): $1.00 per call, GET with a query string. Inputs: set (string, required), category (string), listed (string), offset (number), format (string). Up to 5,000 rows of an x402 market table for $1.00, $0.0002 a row: listing history (each Bazaar listing's category, method, latest price, first and last week seen, weeks listed and price changes) or survival cohorts (each week's new listings by category and how many were still listed one to four weeks on). Filter by category, page with offset, JSON or CSV. Row counts are free at /v1/rows/contents.
- [Fair pick](https://api.agoranome.com/v1/pick): $0.001 per call, GET with a query string. Inputs: job (string, required), budget_usd (number), market (string), limit (integer). Which paid API should my agent call for this job? Paid x402 and MPP endpoints that fit a job in plain words, under your price per call, ranked by a published rule no seller can pay for: only offers that answered payable this week, those that asked what they list first, then a Fair Offer block, then the lower price. From the inspector's signed weekly sheet; anyone can recompute it. Free at agoranome.com/pick.

## 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.
- [Registered agent cards](https://api.agoranome.com/agents): Check an ERC-8004 agent on Base from outside: whether its registration file is valid and points back to it, whether its endpoints answer, whether its x402 offer passes the lint, and how concentrated its feedback is. Look it up by id at /agents/base/{id}.json, or by a host that lists it. Free.
- [Agent payments weekly](https://api.agoranome.com/machines/payments): Agoranome Weekly: agent payments each week, from public counts. Real demand on Base (payments into the busiest Bazaar sellers with catalog sweeps and self-payments taken out), the Bazaar's sellers, new sellers, 4-week survival, price index and Fair Offer share, and x402 SDK downloads. JSON, CSV, RSS and JSON Feed, CC BY 4.0; quarterly report at /machines/payments/{year}-Q{n}. 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.
- [Buyer Safety Index](https://api.agoranome.com/machines/buyer-safety-index): Each x402 client, wallet and agent framework by name and version, examined against eight attacks (price, asset, pay-to and network switches, planted instructions, double-payment bait, an overpayment), with what the first slot and a fake payer count are worth to it and whether it checks evidence before paying. Signed reports, CC BY 4.0; JSON at /machines/buyer-safety-index.json. Free.
- [The price of proof](https://api.agoranome.com/machines/price-of-proof): What a passed certification, an attested sample, pay on delivery, signed receipts, a pledge and the data-not-instructions declaration are worth to buyer-agent models choosing between live x402 offers, and how far a fake payer count, urgency or an authority claim moves them, in percent of price, with 95% ranges. Raw trials, CC BY 4.0; JSON at /machines/price-of-proof.json. Free.
- [Admission feed](https://api.agoranome.com/machines/admission): By category, the x402 sellers that meet published rules: observed (Agoranome's own paid probe delivered, price and pay-to match the listing, no OFAC match) and certified (plus a passed certification). Signed, never ranked or sold, with a CDP wallet policy, a Cloudflare Agents callback, a Cedar policy and CSV. Free; JSON at /machines/admission.json.
- [Which x402 offers deliver](https://api.agoranome.com/machines/deliver): By category, the live x402 sellers that show a sign of delivering in Agoranome's own evidence: its paid probe delivered, verified deliveries in the evidence commons, or real buyers on Base who came back. In a daily rotation, never ranked or sold, with each seller's card grade and the Buyer check one step away. Made daily; JSON at /machines/deliver.json and /machines/deliver/<category>.json; add ?task=<the task in words> for the category it reads as, with no model. Free.
- [The learning ledger](https://api.agoranome.com/machines/learning): Four of the Lab's parameters (the delivery odds' evidence weights, the choice model's served fit, the report cards' finding points and the front door's synonyms), each moved by one published rule at most once a week, with every move logged beside the score that allowed it. JSON at /machines/learning.json. Free.
- [The Fair Referee](https://api.agoranome.com/referee): The rules Agoranome binds itself to as a referee of x402 sellers: no paid placement, every qualifying seller listed, every list's order stated, methods and coefficients published, its own offers probed and graded by the same code, corrections dated, naming by notice. Signed at /.well-known/fair-referee.json, with a self-exam at /referee.json. Free.
- [Base rates by category](https://api.agoranome.com/machines/base-rates): How often an x402 listing answers, asks its listed price, stays listed for 30 days and delivers when paid, by category, with 95% ranges: the prior a buyer's policy starts from. CC BY 4.0; JSON at /machines/base-rates.json. Free.
- [MCP server report cards](https://api.agoranome.com/mcp-servers): Every remote server in the official MCP Registry, read weekly as an MCP client reads it: the handshake and tool list, tool descriptions scanned for instructions aimed at the agent, hidden characters and exfiltration links, sign-in hygiene, and whether a paid tool asks the price it states. Public two weeks after a server's first read. Free; JSON at /mcp-servers.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 eight 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.
- [Capture verifier](https://api.agoranome.com/v1/fair-offer/capture): For facilitators and sellers' servers that hold a payment until the route answers (x402 auth-capture): POST the offer, the hold and what the route answered, and get a signed capture-or-release decision under the Fair Offer rules. Keeps nothing but a daily count. 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, 100 listings a page. 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 (payer_analytics, weekly_insights, fund_commons, ping, price_position, survival_odds, repeat_demand, proof_value, payer_mix, server_standing, pick_odds, which_delivers, research_brief, insights_page, row_set, fair_pick) plus a free rank_sample, check_fair_offer and check_offer. row_set, research_brief and buyer_panel each cover several routes above: an argument picks the route, and the 402 states its price. 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"].
- [A2A agent card](https://api.agoranome.com/.well-known/agent-card.json): the same tools as skills of an A2A agent (A2A 1.0 and 0.3, JSON-RPC at https://api.agoranome.com/a2a), signed. Name a skill in a data part: {"skill": "lint_listing", "arguments": {...}}. A paid skill's task stops in input-required with the x402 PaymentRequired in the status message's metadata x402.payment.required; send the signed payload back in a message with the task's id, in metadata x402.payment.payload (the a2a-x402 extension, v0.1 and v0.2). The settlement comes back in x402.payment.receipts.
- [Agent skill](https://api.agoranome.com/skills/agoranome-x402-buyer-and-seller-tools/SKILL.md): when and how to use each tool, as a SKILL.md.
- [Pay-safely skill](https://api.agoranome.com/skills/x402-pay-safely/SKILL.md): for any agent with a wallet, when to check an x402 seller before paying it (up to 20 at once, safest first) and how to prove a payment after, 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.
- [MCP server card](https://api.agoranome.com/mcp/server-card): the MCP server's name, version and how to connect, before connecting (the MCP Server Card extension), listed in https://api.agoranome.com/.well-known/ai-catalog.json.
- Rate limit: Each caller may make 240 requests a minute, and 12 a minute to the free tools that run a check or a search. Over that, the answer is 429 with Retry-After: wait that many seconds and try again.
- [Terms of service](https://api.agoranome.com/terms): what we offer, paying and refunds, results as data, fair use.
- [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.