{"uid":"cap_eI71CIn4SiS1qL5dQblq1","slug":"speraxos-erc-8004-agent-feedback-submission-d0a5eb61","name":"SperaxOS ERC-8004 Agent Feedback Submission","description":"AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.","url":"https://chat.sperax.io/api/x402/tools/erc8004/submitFeedback?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","default":"bsc-testnet","description":"Blockchain where the agent is registered"},"score":{"type":"number","maximum":127,"minimum":-128,"description":"Reputation score from -128 to 127"},"agentId":{"type":"string","description":"The token ID of the agent to rate"},"comment":{"type":"string","description":"Text feedback/review for the agent"}}},"responseSchema":null,"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_-PyN3EV2WKHojAOUGBfdZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0xD74f5255D557944cf7Dd0E45FF521520002D5748","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a reputation score and text feedback for an on-chain agent registered under the ERC-8004 standard on a specified blockchain","exampleAgentPrompt":"Submit feedback for agent ID 42 on bsc-testnet with a reputation score of 85 and the comment 'Executed the swap efficiently with no slippage issues'.","exampleUseCases":[{"title":"Penalizing a misbehaving DeFi agent","prompt":"Rate agent ID 17 on bsc-testnet with a reputation score of -50 and a comment saying 'This agent failed to execute the trade and lost gas fees without refunding'."},{"title":"Endorsing a high-performing agent","prompt":"Submit positive feedback for agent token ID 99 on bsc-testnet — give it a score of 120 and write 'Consistently profitable yield strategies, highly recommend'."},{"title":"Neutral audit review after agent trial","prompt":"Leave a review for agent ID 55 on bsc-testnet with a score of 0 and a comment: 'Agent performed within expected parameters during the test period, no issues observed but no standout results either'."}],"resultDescription":"A confirmation that the feedback and reputation score have been recorded on-chain for the specified agent token ID, typically returning a transaction reference or success status.","failureModes":["Invalid agentId (non-existent token ID) returns an error","Score outside the -128 to 127 range is rejected","Unsupported chain identifier causes a routing error","Payment of 0.001 USDC via x402 protocol fails if wallet has insufficient balance","Malformed comment field may be rejected","Network congestion on the target chain can delay submission"],"whenToPreferThis":"Use this endpoint when you need to record on-chain reputation data for an ERC-8004 registered agent, especially in DeFi or multi-agent ecosystems where agent trustworthiness is tracked via numeric scores and text reviews. Prefer this over off-chain rating systems when immutability and on-chain verifiability of the reputation record are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:45:35.939Z","isFirstParty":false,"canonicalSlug":"speraxos-erc-8004-agent-feedback-submission-d0a5eb61"}