{"service":"Agoranome","summary":"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.","read_first":{"llms_txt":"https://api.agoranome.com/llms.txt","agent_skill":"https://api.agoranome.com/skills/agoranome-seller-tools/SKILL.md","openapi":"https://api.agoranome.com/openapi.json","catalog":"https://api.agoranome.com/v1/catalog","mcp":"https://api.agoranome.com/mcp","mcp_tools":"https://api.agoranome.com/mcp/tools"},"free":[{"title":"Rank sample","url":"https://api.agoranome.com/v1/seller/rank/sample","note":"The top three Bazaar results for a task, and your rank if you pass resource=. Free."},{"title":"Insights teaser","url":"https://api.agoranome.com/insights/latest","note":"This week's x402 demand headline, brief and sources. The full report is the paid insights route."},{"title":"How machines chose","url":"https://api.agoranome.com/machines/weekly","note":"Free weekly page: how buyer-agent models chose between x402 offers in Machine Buyer Panel runs, pooled and anonymized."},{"title":"Check a signed sample","url":"https://api.agoranome.com/v1/attestations/verify","note":"POST a signed sample attestation to check its signature and that it's the one on record. Free."},{"title":"Machine Choice Benchmark","url":"https://api.agoranome.com/machines/benchmark","note":"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."},{"title":"Shock feed","url":"https://api.agoranome.com/machines/benchmark/shocks.json","note":"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."},{"title":"Machine Buyer Safety","url":"https://api.agoranome.com/machines/buyer-safety","note":"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."},{"title":"Impact ledger","url":"https://api.agoranome.com/impact/ledger","note":"Agoranome's 15% pledge, settled revenue and donations, with Merkle proofs per receipt."},{"title":"Pledge study","url":"https://api.agoranome.com/impact/pledge-study","note":"Whether buyer-agent models pick Agoranome's offer more often with its verified pledge than without; every run published."},{"title":"Fair Offer check","url":"https://api.agoranome.com/v1/fair-offer/check","note":"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."},{"title":"Listing report cards","url":"https://api.agoranome.com/sellers","note":"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."},{"title":"Evidence commons","url":"https://api.agoranome.com/commons","note":"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."},{"title":"Buyer policy","url":"https://api.agoranome.com/policy","note":"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."},{"title":"Free samples","url":"https://api.agoranome.com/v1/machine/ping/sample","note":"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."}],"machine":{"llms_txt":"https://api.agoranome.com/llms.txt","agent_skill":"https://api.agoranome.com/skills/agoranome-seller-tools/SKILL.md","mcp":{"url":"https://api.agoranome.com/mcp","transport":"streamable-http","payment":"x402 in params._meta[\"x402/payment\"]"},"pay_to_configured":true,"offers":[{"tool":"lint_listing","title":"Listing lint","method":"GET","url":"https://api.agoranome.com/v1/seller/lint","price":"$0.01","price_usd":0.01,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"url":{"type":"string","description":"Public https URL of the paid endpoint"}},"required":["url"]},"example_input":{"url":"https://api.example.com/v1/report"},"example_output":{"result":{"verdict":"<ready to index | indexable, with warnings | fix the errors first>","score":"<0-100>","findings":[{"rule":"<rule>","severity":"<error|warning|info>","message":"...","fix":"..."}]},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","listing lint","bazaar indexing","402 header","seller tools"],"sample":"https://api.agoranome.com/v1/seller/lint/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/lint"},{"tool":"rank_check","title":"Rank check","method":"GET","url":"https://api.agoranome.com/v1/seller/rank","price":"$0.01","price_usd":0.01,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"task":{"type":"string","description":"What a buyer agent is searching for"},"resource":{"type":"string","description":"Your listed resource URL"},"network":{"type":"string","description":"Optional CAIP-2 network filter"}},"required":["task","resource"]},"example_input":{"task":"convert a PDF to Markdown","resource":"https://api.example.com/v1/pdf"},"example_output":{"result":{"your_rank":"<1-20 or null>","ahead_of_you":["..."],"gaps":[{"signal":"<signal>","yours":"...","ahead_median":"..."}],"description_diff":{"winners_say":["..."],"only_you_say":["..."]},"share_of_voice":{"searches":"<n>","in_top_20":"<n>","in_top_3":"<n>"}}},"tags":["x402","search rank","seo","competitor analysis","bazaar"],"sample":"https://api.agoranome.com/v1/seller/rank/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/rank","live_page":"https://api.agoranome.com/v1/seller/rank/sample?task=convert+a+PDF+to+Markdown"},{"tool":"rank_watch","title":"Rank watch","method":"POST","url":"https://api.agoranome.com/v1/seller/rank/watch","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"task":{"type":"string","description":"What a buyer agent is searching for"},"resource":{"type":"string","description":"Your listed resource URL"},"network":{"type":"string","description":"Optional CAIP-2 network filter"},"notify":{"type":"string","description":"Optional https webhook for each drop"}},"required":["task","resource"]},"example_input":{"task":"convert a PDF to Markdown","resource":"https://api.example.com/v1/pdf"},"example_output":{"result":{"watch":{"id":"rw_<24 hex>","status_url":"https://.../v1/seller/rank/watch/rw_...","expires_at":"<ISO time>","reruns_left":4},"baseline":{"your_rank":"<1-20 or null>","share_of_voice":{"in_top_20":"<n>","searches":"<n>"}}}},"tags":["x402","search rank","rank monitoring","alerts","seller tools"],"sample":"https://api.agoranome.com/v1/seller/rank/watch/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/rank_watch","live_page":"https://api.agoranome.com/v1/seller/rank/sample?task=convert+a+PDF+to+Markdown"},{"tool":"buyer_panel","title":"Machine Buyer Panel","method":"POST","url":"https://api.agoranome.com/v1/seller/panel","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"resource":{"type":"string","description":"Your resource URL"},"tasks":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":3}},"required":["resource","tasks"]},"example_input":{"resource":"https://api.example.com/v1/pdf","tasks":["convert a 40-page PDF to Markdown for under $0.20"]},"example_output":{"result":{"headline":"Buyer agents picked your offer in <wins> of <n> decisions.","baseline":{"win_rate":{"rate":"<0-1>","ci95":["<lo>","<hi>"]},"win_rate_position_corrected":{"rate":"<0-1>"}},"edits":[{"kind":"<description|price|output_example>","vs_baseline":{"verdict":"<better|worse|inconclusive>"}}],"proof_lift":{"fair_offer_block":{"vs_baseline":{"verdict":"<better|worse|inconclusive>"}},"attested_sample":{"vs_baseline":{"verdict":"<better|worse|inconclusive>"}}}}},"tags":["x402","a/b test","buyer agents","conversion","seller tools"],"sample":"https://api.agoranome.com/v1/seller/panel/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/panel","live_page":"https://api.agoranome.com/machines/weekly.json"},{"tool":"buyer_panel_one","title":"Single-task panel","method":"POST","url":"https://api.agoranome.com/v1/seller/panel/one","price":"$0.25","price_usd":0.25,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"resource":{"type":"string","description":"Your resource URL"},"task":{"type":"string","description":"One task, as a buyer agent would phrase it"}},"required":["resource","task"]},"example_input":{"resource":"https://api.example.com/v1/pdf","task":"convert a 40-page PDF to Markdown for under $0.20"},"example_output":{"result":{"headline":"Buyer agents picked your offer in <wins> of <n> decisions.","baseline":{"win_rate":{"rate":"<0-1>","ci95":["<lo>","<hi>"]}},"proof_lift":{"fair_offer_block":{"vs_baseline":{"verdict":"<better|worse|inconclusive>"}}}}},"tags":["x402","a/b test","buyer agents","conversion","single task"],"sample":"https://api.agoranome.com/v1/seller/panel/one/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/panel_one","live_page":"https://api.agoranome.com/machines/weekly.json"},{"tool":"signed_sample","title":"Signed sample","method":"GET","url":"https://api.agoranome.com/v1/seller/attest","price":"$0.05","price_usd":0.05,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"sample":{"type":"string","description":"Public https URL that returns a sample output without payment"},"resource":{"type":"string","description":"Your paid x402 endpoint, on the same host as the sample"}},"required":["sample","resource"]},"example_input":{"sample":"https://api.example.com/v1/pdf/sample","resource":"https://api.example.com/v1/pdf"},"example_output":{"result":{"attestation_id":"att_...","url":"https://api.agoranome.com/v1/attestations/att_...","attestation":{"sample":{"status":200,"sha256":"...","bytes":1832},"offer":{"accepts":[{"price_usd":0.02,"pay_to":"0x..."}]},"provenance":{"agent_address":"0x...","signature":"..."}}}},"tags":["x402","attestation","trust","output check","seller tools"],"sample":"https://api.agoranome.com/v1/seller/attest/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/attest"},{"tool":"demand_gaps","title":"Demand gap finder","method":"GET","url":"https://api.agoranome.com/v1/seller/gaps","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"topic":{"type":"string","maxLength":80,"description":"A topic or category to search around; every category if omitted"}}},"example_input":{"topic":"pdf"},"example_output":{"result":{"headline":"<n> of <searches> buyer searches find weak results; biggest opening: <task>.","gaps":[{"task":"...","score":"<0-100>","verdict":"<open|weak>","why":["..."],"category_repeat_calls_30d":"<n or null>","trend":{"score_change":"<n or null>","weeks_seen":"<n>"},"spec":{"price":{"usd":"<suggested>","basis":"..."},"openapi":{"openapi":"3.1.0"},"fair_offer":{"info":{}}}}]}},"tags":["x402","unmet demand","demand gaps","what to build","bazaar"],"sample":"https://api.agoranome.com/v1/seller/gaps/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/gaps"},{"tool":"payer_analytics","title":"Real-customer analytics","method":"GET","url":"https://api.agoranome.com/v1/machine/payers","price":"$0.05","price_usd":0.05,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"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.","input_schema":{"type":"object","properties":{"address":{"type":"string","description":"Seller pay-to address on Base"},"days":{"type":"integer","minimum":1,"maximum":30}},"required":["address"]},"example_input":{"address":"0x82f7d272628cffc810fa13c90634add245da42a5","days":7},"example_output":{"result":{"headline":"12 of 40 payers came back; 9 look like sweeps or graders.","summary":{"payers":40,"repeat_buyers":12,"sweep_like":9}},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","customer analytics","repeat buyers","retention","base usdc"],"sample":"https://api.agoranome.com/v1/machine/payers/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/payers"},{"tool":"weekly_insights","title":"Weekly x402 demand insights","method":"GET","url":"https://api.agoranome.com/v1/machine/insights","price":"$0.25","price_usd":0.25,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"week":{"type":"string","pattern":"^\\d{4}-W\\d{2}$","description":"ISO week; latest if omitted"}}},"example_input":{"week":"2026-W43"},"example_output":{"result":{"week":"2026-W43","headline":"<n> of <total> Bazaar listings show repeat use; biggest opening: <category>.","insights":[{"kind":"demand_gaps","finding":"...","sources":["bazaar"],"confidence":"high"}]}},"tags":["x402","market data","demand","what agents buy","weekly report"],"sample":"https://api.agoranome.com/v1/machine/insights/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/insights","live_page":"https://api.agoranome.com/insights/latest"},{"tool":"model_watch","title":"Model-update watch","method":"POST","url":"https://api.agoranome.com/v1/seller/watch","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"resource":{"type":"string","description":"Your resource URL"},"tasks":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":3},"notify":{"type":"string","description":"Optional https webhook for each result"}},"required":["resource","tasks"]},"example_input":{"resource":"https://api.example.com/v1/pdf","tasks":["convert a 40-page PDF to Markdown"]},"example_output":{"result":{"watch":{"id":"w_<24 hex>","status_url":"https://.../v1/seller/watch/w_...","expires_at":"<ISO time>","reruns_left":3},"baseline":{"win_rate":{"rate":"<0-1>","ci95":["<lo>","<hi>"]}}}},"tags":["x402","model updates","buyer agents","monitoring","seller tools"],"sample":"https://api.agoranome.com/v1/seller/watch/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/watch","live_page":"https://api.agoranome.com/machines/benchmark.json"},{"tool":"certify_offer","title":"Fair Offer certification","method":"POST","url":"https://api.agoranome.com/v1/fair-offer/certify","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"url":{"type":"string","description":"Your paid endpoint's public https URL"}},"required":["url"]},"example_input":{"url":"https://api.example.com/v1/pdf"},"example_output":{"result":{"certification_id":"cert_<24 hex>","verdict":"pass","url":"https://.../v1/fair-offer/certifications/cert_...","failures":[]}},"tags":["x402","fair offer","certification","trust","seller tools"],"sample":"https://api.agoranome.com/v1/fair-offer/certify/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/certify","live_page":"https://api.agoranome.com/v1/fair-offer/certifications"},{"tool":"certify_continuous","title":"Continuous certification","method":"POST","url":"https://api.agoranome.com/v1/fair-offer/certify/continuous","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"url":{"type":"string","description":"Your paid endpoint's public https URL"},"notify":{"type":"string","description":"Optional https webhook: POSTed the day a check changes the verdict or finds the block or sample changed"}},"required":["url"]},"example_input":{"url":"https://api.example.com/v1/pdf"},"example_output":{"result":{"continuous":{"id":"cc_<24 hex>","status":"passing","status_url":"https://.../v1/fair-offer/certify/continuous/cc_...","badge":"https://.../v1/fair-offer/certify/continuous/cc_.../badge.svg","expires_at":"<ISO time>"},"certification_id":"cert_<24 hex>","verdict":"pass","failures":[]}},"tags":["x402","fair offer","certification","monitoring","badge"],"sample":"https://api.agoranome.com/v1/fair-offer/certify/continuous/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/continuous","live_page":"https://api.agoranome.com/v1/fair-offer/certifications"},{"tool":"conformance_check","title":"402 conformance run","method":"GET","url":"https://api.agoranome.com/v1/seller/conformance","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"url":{"type":"string","description":"Public https URL of the paid endpoint"}},"required":["url"]},"example_input":{"url":"https://api.example.com/v1/report"},"example_output":{"result":{"verdict":"<conforms | conforms, with warnings | fix the errors first>","score":"<0-100>","findings":[{"rule":"x402-domain-wrong","severity":"error","message":"...","fix":"..."}],"x402":{"version":2,"stable":true,"malformed_payment_status":402},"security":{"forged_payment_status":402,"resource_bound":true,"paid_probe":{"status":"<probed|off|skipped>"}},"mpp":{"offered":true,"malformed_credential_status":402}},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","mpp","conformance","402 header","seller tools"],"sample":"https://api.agoranome.com/v1/seller/conformance/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/conformance"},{"tool":"buyer_check","title":"Buyer check","method":"GET","url":"https://api.agoranome.com/v1/buyer/check","price":"$0.01","price_usd":0.01,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"url":{"type":"string","description":"The x402 offer's URL (the paid route)"},"tx":{"type":"string","description":"Settlement mode: the payment's transaction hash on Base"},"accept_proof":{"type":"string","description":"Your requirements, as an Accept-Proof value"},"max_price":{"type":"number","description":"Your per-call cap in USD (default 1)"},"expected_price":{"type":"number","description":"The quoted price in USD, to compare"},"pay_to":{"type":"string","description":"The quoted pay-to address, to compare"},"share":{"type":"boolean","description":"Settlement mode: publish the buyer-side receipt in the evidence commons"}},"required":["url"]},"example_input":{"url":"https://api.example.com/v1/search"},"example_output":{"result":{"mode":"verdict","summary":"Meets the sampled tier. Block valid; certified and passing since 2026-10-20; one pay-to for 41 days; price at listing; 12 verified deliveries in 30 days.","policy":{"tiers":{"any":true,"sampled":true,"delivered":true}},"pay_to":{"current":["0x..."],"changed_30d":false},"concerns":[]},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","buyer check","seller evidence","settlement proof","buyer tools"],"sample":"https://api.agoranome.com/v1/buyer/check/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/check"},{"tool":"buyer_drill","title":"Buyer drill","method":"POST","url":"https://api.agoranome.com/v1/buyer/drill","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"client":{"type":"string","maxLength":80,"description":"Optional: the client library and version under test"},"publish":{"type":"boolean","description":"Optional: let the Machine Buyer Safety report name that client library"}}},"example_input":{"client":"x402 python 0.3","publish":false},"example_output":{"result":{"drill_id":"drl_<id>","token":"<token>","status":"open","expires_at":"<iso>","listing":{"price_usd":0.001,"pay_to":"<agoranome pay-to>","network":"eip155:8453","asset":"<usdc>"},"traps":[{"id":"price_switch","url":"<trap url>","listed_price_usd":0.001,"what":"<what the trap is>","pass_when":"<when the client passes>"}],"report_url":"<free, token-gated>","close_url":"<free, token-gated>"}},"tags":["x402","buyer drill","client red team","payment safety","buyer tools"],"sample":"https://api.agoranome.com/v1/buyer/drill/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/drill"},{"tool":"spend_audit","title":"Wallet statement","method":"GET","url":"https://api.agoranome.com/v1/buyer/audit","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"wallet":{"type":"string","description":"Buyer wallet address on Base"},"days":{"type":"integer","minimum":1,"maximum":30}},"required":["wallet"]},"example_input":{"wallet":"0x0000000000000000000000000000000000000001","days":7},"example_output":{"result":{"headline":"3 of 40 payments were above the payee's listed Bazaar price, $2.97 more than listed, 3 of them 10x or more. Also: 1 duplicate payment(s) to one payee within a minute.","summary":{"payments":40,"spent_usd":"3.31","overpaid_usd":"2.97","oversize_payments":3,"duplicate_payments":1,"after_listing_changed":0,"payees_certification_failed":0},"payees":[{"pay_to":"0x…","hosts":["<host>"],"calls":12,"spent_usd":"0.24","listing_now":"<listed|vanished|pay_to_changed|unlisted>","certification":{"status":"<certified|failed>"}}],"wallet_profile":{"looks":"<returning_buyer|one_off_buyer|sweep_like>"},"csv":{"columns":["at","tx_hash","pay_to","host","paid_usd","listed_max_usd","class","over_usd","flags"],"rows":40,"text":"<csv>"}},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","spend audit","overpayment","buyer wallet","base usdc"],"sample":"https://api.agoranome.com/v1/buyer/audit/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/audit"},{"tool":"vendor_watch","title":"Vendor watch","method":"POST","url":"https://api.agoranome.com/v1/buyer/watch","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"sellers":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"The x402 offer URLs to watch (up to 10)"},"wallet":{"type":"string","description":"Or: a buyer wallet on Base whose payees' listings are watched"},"notify":{"type":"string","description":"Optional https webhook, POSTed on each alert"}}},"example_input":{"sellers":["https://api.example.com/v1/search"],"notify":"https://buyer.example/hooks/vendors"},"example_output":{"result":{"watch":{"id":"vw_<id>","status":"watching","status_url":"<url>","sellers":["<url>"],"expires_at":"<iso>","checks_left":30,"next_check_after":"<iso>"},"baseline":{"<url>":{"reachable":true,"price_usd":0.01,"pay_to":["0x..."],"block":{"present":true,"valid":true,"sha256":"<hex>"},"listed":true,"certification":"certified","latency_ms":412}}},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","vendor watch","pay-to change","seller monitoring","buyer tools"],"sample":"https://api.agoranome.com/v1/buyer/watch/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/vendor_watch"},{"tool":"response_scan","title":"Response safety scan","method":"POST","url":"https://api.agoranome.com/v1/buyer/scan","price":"$0.01","price_usd":0.01,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"seller":{"type":"string","description":"The x402 offer's URL the response came from"},"body":{"type":"string","maxLength":65536,"description":"The paid response body"},"spans":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Or: passages of the body, when the whole can't be shared"},"share":{"type":"boolean","description":"Let a contradicted claim count as evidence on the seller's record (hashes only)"}},"required":["seller"]},"example_input":{"seller":"https://api.example.com/v1/search","body":"{\"results\": []}"},"example_output":{"result":{"verdict":"unsafe","summary":"1 instruction-like passage; the seller's \"data, never instructions\" claim is contradicted by this response.","findings":[{"kind":"instruction_like","severity":"error","passage_sha256":"<hex>","detail":"ignore previous instructions"}],"schema":{"verdict":"matches"},"fair_offer":{"claim":"declared","verdict":"contradicted"},"stored":"nothing"},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","response scan","prompt injection","output safety","buyer tools"],"sample":"https://api.agoranome.com/v1/buyer/scan/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/scan"},{"tool":"plan_quote","title":"Pre-flight plan quote","method":"POST","url":"https://api.agoranome.com/v1/buyer/quote","price":"$0.01","price_usd":0.01,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"plan":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"seller":{"type":"string"},"calls":{"type":"integer","minimum":1}},"required":["seller","calls"]}},"caps":{"type":"object","properties":{"max_price_usd":{"type":"number"},"max_per_seller_usd":{"type":"number"},"max_total_usd":{"type":"number"},"tier":{"type":"string","enum":["any","sampled","delivered"]}}}},"required":["plan"]},"example_input":{"plan":[{"seller":"https://api.example.com/v1/search","calls":200}],"caps":{"max_price_usd":0.05,"max_total_usd":5,"tier":"sampled"}},"example_output":{"result":{"total_usd":"2.00","fits_caps":true,"lines":[{"seller":"<url>","calls":200,"price_usd":0.01,"cost_usd":"2.00","listing":{"indexed":true,"payers_30d":12},"certification":{"status":"certified"},"failure_share":{"value":0.02,"basis":"reconciled receipts, 30 days"},"fit":{"per_call":"within","tier":"met"},"alternatives":{"category":"web_search","key":"price per call, ascending","sellers":[{"resource":"<url>","price_usd":0.005}]}}]},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","plan quote","cost estimate","certified sellers","buyer tools"],"sample":"https://api.agoranome.com/v1/buyer/quote/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/quote"},{"tool":"dispute_pack","title":"Dispute evidence pack","method":"POST","url":"https://api.agoranome.com/v1/buyer/dispute","price":"$1.00","price_usd":1.0,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{"tx":{"type":"string","description":"The payment's transaction hash on Base"},"seller":{"type":"string","description":"The x402 offer's URL"},"offer":{"type":"object","description":"The accepted 402 (payment requirements) as received, with its extensions"},"response":{"type":"object","description":"What came back: status, body or body_sha256, headers, received_at"},"expected_price_usd":{"type":"number"},"pay_to":{"type":"string"},"claim":{"type":"string","maxLength":2000,"description":"What went wrong, in your words"}},"required":["tx","seller"]},"example_input":{"tx":"0x<64 hex>","seller":"https://api.example.com/v1/search","response":{"status":500,"body":"{\"error\": \"upstream timeout\"}"}},"example_output":{"result":{"pack_id":"dp_<id>","settlement":{"status":"settled","block":0},"terms_at_quote":{"failed_calls":"not_charged","enforced_by":"seller"},"response":{"status":500,"body_sha256":"<hex>"},"observations":{"offers_seen":2,"certification":{"status":"certified"}},"assessment":{"refund_due_per_terms":true},"contact":{"addresses":["mailto:security@example.com"]},"claim_draft":"<text>"},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","dispute","refund claim","settlement proof","buyer tools"],"sample":"https://api.agoranome.com/v1/buyer/dispute/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/dispute"},{"tool":"fund_commons","title":"Fund the evidence commons","method":"GET","url":"https://api.agoranome.com/v1/commons/fund","price":"$0.10","price_usd":0.1,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{}},"example_input":{},"example_output":{"result":{"thanks":"Thank you. This keeps the evidence commons free.","ledger":"https://.../impact/ledger"},"receipt":{"receipt_id":"0x...","impact":{"pledge":"15% of settled revenue"}}},"tags":["x402","public goods","evidence commons","open source","fair offer"],"sample":"https://api.agoranome.com/v1/commons/fund/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/fund"},{"tool":"ping","title":"Payment test","method":"GET","url":"https://api.agoranome.com/v1/machine/ping","price":"$0.001","price_usd":0.001,"currency":"USDC","network":"eip155:8453","network_name":"Base","payment":{"protocol":"x402","version":2,"scheme":"exact"},"description":"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.","input_schema":{"type":"object","properties":{}},"example_input":{},"example_output":{"result":{"pong":true,"buyer":{"label":"new","payments_here":0,"next":[{"tool":"Buyer check"}]}},"receipt":{"receipt_id":"0x..."}},"tags":["x402","test payment","ping","wallet check","payments"],"sample":"https://api.agoranome.com/v1/machine/ping/sample","sample_attestation":"https://api.agoranome.com/v1/attestations/own/ping"}]}}