{"uid":"cap_agPhJ9U_HBJYjodmAjT1m","slug":"rate-a-paid-api-call-agent402-tools-feedback-ee4bf82c","name":"Rate a Paid API Call (agent402.tools Feedback)","description":"Tell this server whether a call you paid for delivered what it promised. Bound to the receipt: give it the settlement transaction from that call's PAYMENT-RESPONSE (or Payment-Receipt) header and a verdict of \"good\" or \"bad\", and only the wallet the ledger records as having paid for that exact call can write it - so a rating here is always a real customer about a real purchase. One verdict per settlement transaction (sending another replaces yours, it never stacks).","url":"https://agent402.tools/api/feedback","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tx":{"type":"string","description":"Settlement transaction of the call you are rating, as carried in that response's PAYMENT-RESPONSE (x402) or Payment-Receipt (MPP) header."},"reason":{"type":"string","description":"What happened, in your own words. Optional on \"good\", required on \"bad\" (10 characters minimum, 1000 maximum). Stored for the operator, never published."},"verdict":{"type":"string","description":"\"good\" (it delivered what it promised) or \"bad\" (it did not)."}}},"responseSchema":{"type":"json","example":{"item":"crypto-price","note":"responseSha256 is sha256 over the exact JSON bytes that call returned. It identifies the answer your verdict is about.","verdict":"good","recorded":true,"replaced":false,"amountUsd":0.01,"settledAt":"2026-09-03T15:16:06.000Z","settlementTx":"0x2f1fecade9bd945e7817c11e5a34cafe6b349dd8c92a7587efed1de476bddfeb","responseSha256":"7d2a9b1c4e6f8a0b2c4d6e8f0a1b3c5d7e9f1a3b5c7d9e1f3a5b7c9d1e3f5a7b"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PvEuFyGAaKwRIAYNOAd1_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a 'good' or 'bad' verdict for a specific x402-paid API call, tied to its settlement transaction, so only the wallet that paid can rate it.","exampleAgentPrompt":"Rate that last paid API call as bad — the settlement transaction is 0x2f1fecade9bd945e7817c11e5a34cafe6b349dd8c92a7587efed1de476bddfeb and the reason is 'the crypto price returned was stale by over 10 minutes'.","exampleUseCases":[{"title":"Flag a failed paid tool response","prompt":"Mark the API call I just paid for as bad — the settlement tx is 0xabc123...def and the reason is 'the conversion result was completely wrong, it returned zero instead of the correct value'."},{"title":"Confirm a successful paid API result","prompt":"Submit a good verdict for the call with settlement transaction 0x9fa2b...c847 — it delivered the crypto price exactly as promised."},{"title":"Replace an earlier mistaken rating","prompt":"I accidentally rated a call as bad — can you submit a new good verdict for settlement transaction 0x5d3e1...7c92? There's no explanation needed since it's a positive rating."}],"resultDescription":"A JSON object confirming whether the verdict was recorded and whether it replaced a previous one, along with the item name, settlement transaction, amount paid in USD, settlement timestamp, and a SHA256 hash of the exact response bytes the rating is about.","failureModes":["Wrong wallet submitting — only the wallet that paid for the call can rate it; returns authorization error","Settlement transaction not found — if the tx ID doesn't match a known paid call, returns not found error","Duplicate verdict without replacement — sending the same verdict again replaces the old one rather than stacking","'bad' verdict missing reason — reason is required (10+ chars) for bad verdicts, omitting it returns a validation error","Reason too short or too long — below 10 or above 1000 characters returns a validation error","Invalid verdict value — only 'good' or 'bad' are accepted"],"whenToPreferThis":"Use this endpoint when an agent has just completed an x402-paid API call and needs to record quality feedback tied to that specific payment. It is the only endpoint that cryptographically binds a rating to both the paying wallet and the exact settlement transaction, making it suitable for trustworthy, tamper-resistant API quality signals in agentic marketplaces. Prefer it over generic review systems when the feedback must be verifiable and wallet-authenticated.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:43:43.780Z","isFirstParty":false}