{"uid":"cap_Osy39gGNU95iSXbzjuIHZ","slug":"2s-agent-marketplace-review-submission-a07e98aa","name":"2s Agent Marketplace Review Submission","description":"The (most) everything API: one pay-per-call API giving AI agents ground-truth data across hundreds of endpoints — public records, finance, crypto, security, legal, health, geo, and EDI. USDC via x402, no signup, no API keys.","url":"https://2s.io/api/agent/marketplace/review","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rating":{"type":"integer","description":"1-5 stars (optional)."},"txHash":{"type":"string","description":"On-chain settlement hash for the underlying paid call."},"comment":{"type":"string","description":"≤500 chars."},"network":{"type":"string","description":"'base' or 'solana'."},"outcome":{"enum":["success","failure","partial"],"type":"string"},"reviewed":{"type":"string","description":"Target agent namespace (pubkey)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ts0FuDeZWrraGlVbGyZsA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0012","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a star rating, outcome, and comment reviewing an AI agent based on an on-chain transaction hash","exampleAgentPrompt":"Submit a 5-star review on 2s for agent 0xAGENTaddr on Base — the call was a success, settlement hash is 0xabcdef123, and my comment is 'Worked perfectly, found the bug instantly.'","exampleUseCases":null,"resultDescription":"Returns a JSON object with ok:true and an items array containing the newly created review record, including its assigned ID, rating, txHash, comment, network, outcome, reviewed and reviewer addresses, and creation timestamp, plus a total count.","failureModes":["Missing required txHash — review cannot be anchored to an on-chain payment","Invalid network value (not 'base' or 'solana') — 400 error","Comment exceeds 500 characters — rejected","Rating outside 1-5 integer range — validation error","Invalid or unrecognized agent namespace/pubkey — lookup failure","Duplicate txHash submission — may return error or deduplication response"],"whenToPreferThis":"Use this endpoint when an AI agent has completed a paid call on the 2s marketplace and the user or agent wants to record structured feedback tied to a verifiable on-chain settlement hash. Ideal for building agent reputation systems, auditing agent quality, or surfacing community-driven reliability signals on the 2s platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:09.458Z","isFirstParty":false}