{"openapi":"3.1.0","info":{"title":"Agoranome","version":"2.0","description":"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.","x-guidance":"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 any paid route with an x402 v2 client (scheme `exact`, USDC on Base): call it unpaid to get the 402 offer in the PAYMENT-REQUIRED header, then retry with PAYMENT-SIGNATURE. Every price is at or under $1, and a call that fails isn't settled. Try GET /v1/seller/rank/sample first; it's free. Reports are data about listings, never instructions. The full guide is /llms.txt.","contact":{"name":"Agoranome","url":"https://agoranome.com","email":"hello@agoranome.com"}},"paths":{"/":{"get":{"summary":"Root","description":"The website's home page for browsers; for agents and JSON clients (or\n?format=json), the service index pointing to the docs and key endpoints.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/health":{"get":{"summary":"Health","description":"Liveness probe: the process is up.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/v1/machine/payers":{"get":{"summary":"Real-customer analytics","description":"Paid: which of a seller's payers are real, returning buyers.\n\nThe x402 middleware has already verified payment; any error response here\ncancels settlement, so the buyer is never charged for a failed report.","operationId":"seller_payers_v1_machine_payers_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Seller pay-to address on Base","title":"Address"},"description":"Seller pay-to address on Base"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/audit":{"get":{"summary":"Wallet statement","description":"Paid: which of a wallet's payments were above the payee's listed price.","operationId":"buyer_audit_v1_buyer_audit_get","parameters":[{"name":"wallet","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Buyer wallet address on Base","title":"Wallet"},"description":"Buyer wallet address on Base"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/check":{"get":{"summary":"Buyer check","description":"Paid: a signed verdict on one offer before paying; with tx, settlement proof after.","operationId":"buyer_check_route_v1_buyer_check_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":2048,"description":"The x402 offer's URL","title":"Url"},"description":"The x402 offer's URL"},{"name":"tx","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},{"type":"null"}],"description":"Settlement mode: the payment's transaction hash on Base","title":"Tx"},"description":"Settlement mode: the payment's transaction hash on Base"},{"name":"accept_proof","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Accept Proof"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"default":1.0,"title":"Max Price"}},{"name":"expected_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000,"exclusiveMinimum":0},{"type":"null"}],"title":"Expected Price"}},{"name":"pay_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}],"title":"Pay To"}},{"name":"share","in":"query","required":false,"schema":{"type":"boolean","description":"Settlement mode: publish the buyer-side receipt in the commons","default":false,"title":"Share"},"description":"Settlement mode: publish the buyer-side receipt in the commons"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/drill":{"post":{"summary":"Buyer drill","description":"Paid: open a buyer drill: a token and nine trap routes, a signed report within 24 hours.","operationId":"buyer_drill_v1_buyer_drill_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DrillReq"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/watch":{"post":{"summary":"Vendor watch","description":"Paid: observe the sellers now and watch them daily for 30 days; alerts to the webhook.","operationId":"buyer_vendor_watch_v1_buyer_watch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorWatchReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/watch/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/watch returns, as its listed example.","operationId":"sample_v1_buyer_watch_v1_buyer_watch_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/scan":{"post":{"summary":"Response safety scan","description":"Paid: is this paid response data, or instructions aimed at the agent?","operationId":"buyer_scan_v1_buyer_scan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/quote":{"post":{"summary":"Pre-flight plan quote","description":"Paid: what a plan of paid calls will cost and risk, and who else is certified in each category.","operationId":"buyer_quote_v1_buyer_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/buyer/dispute":{"post":{"summary":"Dispute evidence pack","description":"Paid: the evidence pack for a payment that was charged and not served, with a draft claim.","operationId":"buyer_dispute_v1_buyer_dispute_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/commons/fund":{"get":{"summary":"Fund the evidence commons","description":"Paid: a contribution to the free evidence commons, with a signed receipt.","operationId":"commons_fund_v1_commons_fund_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/impact/ledger":{"get":{"summary":"Impact Ledger","description":"Free: the pledge, running totals and each month's Merkle root and donations.","operationId":"impact_ledger_impact_ledger_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Proof and impact"]}},"/insights/latest":{"get":{"summary":"Insights Latest","description":"Free teaser: what the full weekly report covers. A browser gets it as a page; agents keep the JSON.","operationId":"insights_latest_insights_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/machine/insights":{"get":{"summary":"Weekly x402 demand insights","description":"Paid: the full report. A missing week returns 404 and cancels settlement.","operationId":"insights_full_v1_machine_insights_get","parameters":[{"name":"week","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Week"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/lint":{"get":{"summary":"Listing lint","description":"Paid: lint one endpoint's live 402 offer.","operationId":"seller_lint_v1_seller_lint_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":2048,"title":"Url"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/conformance":{"get":{"summary":"402 conformance run","description":"Paid: check one offer's live 402 against x402 v2 and MPP, and against its listings.","operationId":"seller_conformance_v1_seller_conformance_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":2048,"title":"Url"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/rank/sample":{"get":{"summary":"Seller Rank Sample","description":"Free: the top three Bazaar results for a task, and the resource's rank if given.\n\nWithout a task it is the route's fixed sample, the listed output example,\nthe same bytes every time so its attestation holds (own_samples.py); the\nlive page is linked from it.","operationId":"seller_rank_sample_v1_seller_rank_sample_get","parameters":[{"name":"task","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":3,"maxLength":400},{"type":"null"}],"title":"Task"}},{"name":"resource","in":"query","required":false,"schema":{"type":"string","maxLength":2048,"default":"","title":"Resource"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/rank":{"get":{"summary":"Rank check","description":"Paid: rank, who is ahead, the signals where the listing trails them, what the winners' descriptions say\nthat yours doesn't, and share of voice across the category's buyer searches.","operationId":"seller_rank_v1_seller_rank_get","parameters":[{"name":"task","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":400,"title":"Task"}},{"name":"resource","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":2048,"title":"Resource"}},{"name":"network","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Network"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/rank/watch":{"post":{"summary":"Rank watch","description":"Paid: the rank check now, then weekly re-checks for 30 days with an alert on every drop.","operationId":"seller_rank_watch_v1_seller_rank_watch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankWatchReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/panel":{"post":{"summary":"Machine Buyer Panel","description":"Paid: one Machine Buyer Panel run. One run at a time; a busy panel answers 429 unpaid.","operationId":"seller_panel_v1_seller_panel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanelReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/panel/one":{"post":{"summary":"Single-task panel","description":"Paid: the single-task panel: the offer as it is and the proof arm, no drafted edits. Shares the panel's lock.","operationId":"seller_panel_one_v1_seller_panel_one_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PanelOneReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/attest":{"get":{"summary":"Signed sample","description":"Paid: fetch a free sample, tie it to the paid offer on the same host, and sign both.","operationId":"seller_attest_v1_seller_attest_get","parameters":[{"name":"sample","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":2048,"title":"Sample"}},{"name":"resource","in":"query","required":true,"schema":{"type":"string","minLength":10,"maxLength":2048,"title":"Resource"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/gaps":{"get":{"summary":"Demand gap finder","description":"Paid: buyer-agent searches whose top Bazaar results are weak.","operationId":"seller_gaps_v1_seller_gaps_get","parameters":[{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Topic"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/seller/watch":{"post":{"summary":"Model-update watch","description":"Paid: a baseline panel test now, then re-tests whenever a panel model changes, for 30 days.","operationId":"seller_watch_v1_seller_watch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/fair-offer/certify":{"post":{"summary":"Fair Offer certification","description":"Paid: certify one offer's Fair Offer block against live behaviour. Published pass or fail.","operationId":"fair_offer_certify_v1_fair_offer_certify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertifyReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/fair-offer/certify/continuous":{"post":{"summary":"Continuous certification","description":"Paid: certify one offer now, then re-run the certification daily for 30 days. Published pass or fail.\nAn optional `notify` https webhook gets a POST the day a check changes the verdict or finds drift.","operationId":"fair_offer_continuous_v1_fair_offer_certify_continuous_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertifyReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/fair-offer/certify/continuous/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/fair-offer/certify/continuous returns, as its listed example.","operationId":"sample_v1_fair_offer_certify_continuous_v1_fair_offer_certify_continuous_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/watch/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/watch returns, as its listed example.","operationId":"sample_v1_seller_watch_v1_seller_watch_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/rank/watch/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/rank/watch returns, as its listed example.","operationId":"sample_v1_seller_rank_watch_v1_seller_rank_watch_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/fair-offer/certifications":{"get":{"summary":"Certifications","description":"Free: every certification run, newest first, passes and fails alike.","operationId":"certifications_v1_fair_offer_certifications_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Start here"]}},"/v1/fair-offer/certifications/lost":{"get":{"summary":"Certifications Lost","description":"Free: a JSON Feed of every Fair Offer certification that passed and then failed.","operationId":"certifications_lost_v1_fair_offer_certifications_lost_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":90,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Start here"]}},"/v1/attestations/own":{"get":{"summary":"Own Attestations","description":"Free: Agoranome's own samples, each attested like a seller's, with the alias every route's block names.","operationId":"own_attestations_v1_attestations_own_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Proof and impact"]}},"/v1/fair-offer/probes":{"get":{"summary":"Paid Probes","description":"Free: every paid probe, newest first.","operationId":"paid_probes_v1_fair_offer_probes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/v1/attestations/verify":{"post":{"summary":"Verify Attestation","description":"Free: is this attestation intact, signed by Agoranome, and the one on record?","operationId":"verify_attestation_v1_attestations_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attestation"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Proof and impact"]}},"/v1/fair-offer/check":{"get":{"summary":"Fair Offer Check","description":"Free: check a live x402 offer's Fair Offer block from outside, without paying.\n\nPass the buyer's requirements as accept_proof= (or an Accept-Proof header)\nto learn whether the offer meets them. Without url=, explains itself.","operationId":"fair_offer_check_v1_fair_offer_check_get","parameters":[{"name":"url","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":10,"maxLength":2048},{"type":"null"}],"title":"Url"}},{"name":"accept_proof","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Accept Proof"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Start here"]}},"/v1/fair-offer/validate":{"post":{"summary":"Fair Offer Validate","description":"Free: validate a Fair Offer block, its info, or a whole 402 body against the 0.2 schema.","operationId":"fair_offer_validate_v1_fair_offer_validate_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/v1/machine/ping":{"get":{"summary":"Payment test","description":"Paid test route: proves a buyer's wallet and client can pay Agoranome, and tells the buyer what the Lab\nknows about its wallet (the commons' label, its payments here) and which tool to try next.","operationId":"machine_ping_v1_machine_ping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","description":"The tool's result."},"receipt":{"type":"object","description":"The payment receipt, with the impact pledge block."}},"required":["result","receipt"]}}}},"402":{"description":"Payment Required. The x402 offer is in the PAYMENT-REQUIRED header."}},"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"tags":["Paid tools"]}},"/v1/catalog":{"get":{"summary":"Service Catalog","description":"Free: every machine-paid offer as JSON, with the free routes and what to read first.","operationId":"service_catalog_v1_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/.well-known/agent-manifest":{"get":{"summary":"Manifest","description":"Free: the agent card: identity, payment, Fair Offer conformance and every offer.","operationId":"manifest__well_known_agent_manifest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[],"tags":["Start here"]}},"/.well-known/security.txt":{"get":{"summary":"Security Txt","operationId":"security_txt__well_known_security_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[],"tags":["Start here"]}},"/skills/agoranome-seller-tools/SKILL.md":{"get":{"summary":"Agent Skill","operationId":"agent_skill_skills_agoranome_seller_tools_SKILL_md_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[],"tags":["Start here"]}},"/mcp/tools":{"get":{"summary":"Mcp Tools","operationId":"mcp_tools_mcp_tools_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/machines/weekly.json":{"get":{"summary":"Weekly Json","operationId":"weekly_json_machines_weekly_json_get","parameters":[{"name":"week","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Week"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/weekly":{"get":{"summary":"Weekly Page","operationId":"weekly_page_machines_weekly_get","parameters":[{"name":"week","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Week"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Samples and reports"]}},"/impact/pledge-study.json":{"get":{"summary":"Pledge Study Json","operationId":"pledge_study_json_impact_pledge_study_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Proof and impact"]}},"/impact/pledge-study":{"get":{"summary":"Pledge Study Page","operationId":"pledge_study_page_impact_pledge_study_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[],"tags":["Proof and impact"]}},"/machines/benchmark.json":{"get":{"summary":"Benchmark Json","operationId":"benchmark_json_machines_benchmark_json_get","parameters":[{"name":"report","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Report"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/benchmark/trials.json":{"get":{"summary":"Benchmark Trials","operationId":"benchmark_trials_machines_benchmark_trials_json_get","parameters":[{"name":"report","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Report"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/benchmark/dataset.jsonl":{"get":{"summary":"Benchmark Dataset","description":"Free: every trial of every report, one JSON object per line, under CC BY 4.0.","operationId":"benchmark_dataset_machines_benchmark_dataset_jsonl_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/benchmark/dataset.json":{"get":{"summary":"Benchmark Dataset Meta","description":"Free: what the dataset holds, its columns, licence and citation.","operationId":"benchmark_dataset_meta_machines_benchmark_dataset_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/benchmark/shocks.json":{"get":{"summary":"Benchmark Shocks","description":"Free: JSON Feed 1.1 of each category's shock index per report, newest first.","operationId":"benchmark_shocks_machines_benchmark_shocks_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/benchmark":{"get":{"summary":"Benchmark Page","operationId":"benchmark_page_machines_benchmark_get","parameters":[{"name":"report","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Report"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/buyer-safety.json":{"get":{"summary":"Buyer Safety Json","operationId":"buyer_safety_json_machines_buyer_safety_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Samples and reports"]}},"/machines/buyer-safety":{"get":{"summary":"Buyer Safety Page","operationId":"buyer_safety_page_machines_buyer_safety_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/machine/ping/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/machine/ping returns, as its listed example.","operationId":"sample_v1_machine_ping_v1_machine_ping_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Machine Ping V1 Machine Ping Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/lint/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/lint returns, as its listed example.","operationId":"sample_v1_seller_lint_v1_seller_lint_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Seller Lint V1 Seller Lint Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/attest/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/attest returns, as its listed example.","operationId":"sample_v1_seller_attest_v1_seller_attest_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Seller Attest V1 Seller Attest Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/machine/payers/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/machine/payers returns, as its listed example.","operationId":"sample_v1_machine_payers_v1_machine_payers_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Machine Payers V1 Machine Payers Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/machine/insights/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/machine/insights returns, as its listed example.","operationId":"sample_v1_machine_insights_v1_machine_insights_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Machine Insights V1 Machine Insights Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/panel/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/panel returns, as its listed example.","operationId":"sample_v1_seller_panel_v1_seller_panel_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Seller Panel V1 Seller Panel Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/gaps/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/gaps returns, as its listed example.","operationId":"sample_v1_seller_gaps_v1_seller_gaps_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Seller Gaps V1 Seller Gaps Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/fair-offer/certify/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/fair-offer/certify returns, as its listed example.","operationId":"sample_v1_fair_offer_certify_v1_fair_offer_certify_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Fair Offer Certify V1 Fair Offer Certify Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/audit/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/audit returns, as its listed example.","operationId":"sample_v1_buyer_audit_v1_buyer_audit_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Buyer Audit V1 Buyer Audit Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/commons/fund/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/commons/fund returns, as its listed example.","operationId":"sample_v1_commons_fund_v1_commons_fund_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Commons Fund V1 Commons Fund Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/conformance/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/conformance returns, as its listed example.","operationId":"sample_v1_seller_conformance_v1_seller_conformance_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Seller Conformance V1 Seller Conformance Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/check/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/check returns, as its listed example.","operationId":"sample_v1_buyer_check_v1_buyer_check_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Buyer Check V1 Buyer Check Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/drill/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/drill returns, as its listed example.","operationId":"sample_v1_buyer_drill_v1_buyer_drill_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Buyer Drill V1 Buyer Drill Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/seller/panel/one/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/seller/panel/one returns, as its listed example.","operationId":"sample_v1_seller_panel_one_v1_seller_panel_one_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Seller Panel One V1 Seller Panel One Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/scan/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/scan returns, as its listed example.","operationId":"sample_v1_buyer_scan_v1_buyer_scan_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Buyer Scan V1 Buyer Scan Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/quote/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/quote returns, as its listed example.","operationId":"sample_v1_buyer_quote_v1_buyer_quote_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Buyer Quote V1 Buyer Quote Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/v1/buyer/dispute/sample":{"get":{"summary":"Free sample","description":"Free: what /v1/buyer/dispute returns, as its listed example.","operationId":"sample_v1_buyer_dispute_v1_buyer_dispute_sample_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sample V1 Buyer Dispute V1 Buyer Dispute Sample Get"}}}}},"security":[],"tags":["Samples and reports"]}},"/commons.json":{"get":{"summary":"Commons Json","description":"Every seller whose receipts the commons has reconciled, with 30-day counts.","operationId":"commons_json_commons_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/commons/receipts.ndjson":{"get":{"summary":"Commons Bulk","description":"Every reconciled receipt of the last 30 days, one JSON object per line (CC BY 4.0).","operationId":"commons_bulk_commons_receipts_ndjson_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/commons/buyer-receipts.ndjson":{"get":{"summary":"Commons Buyer Bulk","description":"Buyer-side receipts of the last 30 days, published with each buyer's consent (CC BY 4.0).","operationId":"commons_buyer_bulk_commons_buyer_receipts_ndjson_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/v1/evidence/validate":{"post":{"summary":"Validate","description":"Check a receipts file (receipts-0.1) or a delivery attestation before publishing it. Free.","operationId":"validate_v1_evidence_validate_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/receipts.json":{"get":{"summary":"Own Receipts","description":"Agoranome's settled sales as a receipts-0.1 file. Self-payments are marked self.","operationId":"own_receipts_receipts_json_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Start here"]}},"/v1/policy/check":{"get":{"summary":"Policy Check","description":"Free: would a buyer's policy pay this offer? Tier any, sampled or delivered; nothing is paid.\nWithout url=, explains itself.","operationId":"policy_check_v1_policy_check_get","parameters":[{"name":"url","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":10,"maxLength":2048},{"type":"null"}],"title":"Url"}},{"name":"tier","in":"query","required":false,"schema":{"type":"string","pattern":"^(any|sampled|delivered)$","default":"sampled","title":"Tier"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number","maximum":1000,"exclusiveMinimum":0,"default":1.0,"title":"Max Price"}},{"name":"expected_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1000,"exclusiveMinimum":0},{"type":"null"}],"title":"Expected Price"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Start here"]}},"/v1/policy/telemetry":{"post":{"summary":"Telemetry","description":"Opt-in, anonymized events from installed policy packs (policy-telemetry-0.1).","operationId":"telemetry_v1_policy_telemetry_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/v1/policy/admission":{"get":{"summary":"Admission","description":"What proof buyers' policies require, how often offers pass, and why they fail (CC BY 4.0).","operationId":"admission_v1_policy_admission_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"tags":["Start here"]}},"/v1/policy/unmet-intents":{"get":{"summary":"Unmet","description":"What buyers tried to buy when no seller passed their policy (CC BY 4.0).","operationId":"unmet_v1_policy_unmet_intents_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-z0-9_]{1,40}$"},{"type":"null"}],"title":"Category"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[],"tags":["Start here"]}}},"components":{"schemas":{"Attestation":{"properties":{"id":{"type":"string","maxLength":64,"title":"Id"},"provenance":{"additionalProperties":true,"type":"object","title":"Provenance"}},"additionalProperties":true,"type":"object","required":["id","provenance"],"title":"Attestation","description":"A signed sample attestation, as Agoranome returned it."},"Caps":{"properties":{"max_price_usd":{"anyOf":[{"type":"number","maximum":1000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Price Usd","description":"Your per-call cap"},"max_per_seller_usd":{"anyOf":[{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Per Seller Usd","description":"Your cap per seller"},"max_total_usd":{"anyOf":[{"type":"number","maximum":1000000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Total Usd","description":"Your cap for the whole plan"},"tier":{"anyOf":[{"type":"string","pattern":"^(any|sampled|delivered)$"},{"type":"null"}],"title":"Tier","description":"The policy tier each seller must meet"}},"type":"object","title":"Caps"},"CertifyReq":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":10,"title":"Url"},"notify":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Notify"}},"type":"object","required":["url"],"title":"CertifyReq"},"DisputeReq":{"properties":{"tx":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","title":"Tx","description":"The payment's transaction hash on Base"},"seller":{"type":"string","maxLength":2048,"minLength":12,"title":"Seller","description":"The x402 offer's URL"},"offer":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Offer","description":"The accepted 402 as received, with its extensions"},"response":{"anyOf":[{"$ref":"#/components/schemas/DisputeResponse"},{"type":"null"}]},"expected_price_usd":{"anyOf":[{"type":"number","maximum":1000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Expected Price Usd"},"pay_to":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}],"title":"Pay To"},"claim":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Claim","description":"What went wrong, in your words"}},"type":"object","required":["tx","seller"],"title":"DisputeReq"},"DisputeResponse":{"properties":{"status":{"anyOf":[{"type":"integer","maximum":599.0,"minimum":100.0},{"type":"null"}],"title":"Status"},"body":{"anyOf":[{"type":"string","maxLength":65536},{"type":"null"}],"title":"Body"},"body_sha256":{"anyOf":[{"type":"string","pattern":"^[0-9a-fA-F]{64}$"},{"type":"null"}],"title":"Body Sha256"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Headers"},"received_at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Received At"}},"type":"object","title":"DisputeResponse"},"DrillReq":{"properties":{"client":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Client","description":"The client library and version under test"},"publish":{"type":"boolean","title":"Publish","description":"Let the Machine Buyer Safety report name that client library","default":false}},"type":"object","title":"DrillReq"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PanelOneReq":{"properties":{"resource":{"type":"string","maxLength":2048,"minLength":10,"title":"Resource"},"task":{"type":"string","maxLength":400,"minLength":3,"title":"Task"}},"type":"object","required":["resource","task"],"title":"PanelOneReq"},"PanelReq":{"properties":{"resource":{"type":"string","maxLength":2048,"minLength":10,"title":"Resource"},"tasks":{"items":{"type":"string"},"type":"array","maxItems":3,"minItems":1,"title":"Tasks"}},"type":"object","required":["resource","tasks"],"title":"PanelReq"},"PlanLine":{"properties":{"seller":{"type":"string","maxLength":2048,"minLength":12,"title":"Seller","description":"The x402 offer's URL"},"calls":{"type":"integer","maximum":10000000.0,"minimum":1.0,"title":"Calls","description":"How many paid calls the plan makes to it"}},"type":"object","required":["seller","calls"],"title":"PlanLine"},"QuoteReq":{"properties":{"plan":{"items":{"$ref":"#/components/schemas/PlanLine"},"type":"array","maxItems":20,"minItems":1,"title":"Plan"},"caps":{"anyOf":[{"$ref":"#/components/schemas/Caps"},{"type":"null"}]}},"type":"object","required":["plan"],"title":"QuoteReq"},"RankWatchReq":{"properties":{"task":{"type":"string","maxLength":400,"minLength":3,"title":"Task"},"resource":{"type":"string","maxLength":2048,"minLength":10,"title":"Resource"},"network":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Network"},"notify":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Notify"}},"type":"object","required":["task","resource"],"title":"RankWatchReq"},"ScanReq":{"properties":{"seller":{"type":"string","maxLength":2048,"minLength":12,"title":"Seller","description":"The x402 offer's URL the response came from"},"body":{"anyOf":[{"type":"string","maxLength":65536},{"type":"null"}],"title":"Body","description":"The paid response body"},"spans":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":50},{"type":"null"}],"title":"Spans","description":"Or: passages of the body, when the whole can't be shared"},"share":{"type":"boolean","title":"Share","description":"Let a contradicted claim count as evidence on the seller's record (hashes only)","default":false}},"type":"object","required":["seller"],"title":"ScanReq"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VendorWatchReq":{"properties":{"sellers":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":10},{"type":"null"}],"title":"Sellers","description":"The x402 offer URLs to watch (up to 10)"},"wallet":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}],"title":"Wallet","description":"Or: a buyer wallet on Base whose payees' listings are watched"},"notify":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Notify","description":"Optional https webhook, POSTed on each alert"}},"type":"object","title":"VendorWatchReq"},"WatchReq":{"properties":{"resource":{"type":"string","maxLength":2048,"minLength":10,"title":"Resource"},"tasks":{"items":{"type":"string"},"type":"array","maxItems":3,"minItems":1,"title":"Tasks"},"notify":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Notify"}},"type":"object","required":["resource","tasks"],"title":"WatchReq"}}},"tags":[{"name":"Paid tools","description":"Pay per call; each operation's x-payment-info gives its price and how to pay."},{"name":"Proof and impact","description":"Signed attestations, receipt proofs and the impact ledger."},{"name":"Samples and reports","description":"Free samples of the paid tools and the weekly market reports."},{"name":"Start here","description":"What an agent reads first: the catalog, llms.txt, the skill, MCP tools and health."}],"x-service-info":{"categories":["developer-tools","marketplace","analytics"],"docs":{"homepage":"https://agoranome.com","llms":"https://api.agoranome.com/llms.txt","apiReference":"https://api.agoranome.com/openapi.json"}},"x-agentcash-guidance":{"llmsTxtUrl":"https://api.agoranome.com/llms.txt"}}