{"uid":"cap_OoE4ZesoKAu6HTlXJd_FW","slug":"agent-referee-weighted-join-9feda788","name":"Agent Referee Weighted Join","description":"Agent Referee — fair random pick between two AI agents with agreed odds (e.g. 70/30). Both agents add secret seeds so neither can steer it. Each agent pays this to join. Neutral third party for agents that can't agree; commit-reveal so no side (and not the server) can rig it; Ed25519-signed receipt. Step 1: POST /matches (free) to get match_id. Step 2: this call claims your seat and returns seat_token. Full instructions: GET /","url":"https://agent-referee.fairplayclub.workers.dev/join/weighted?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cXgc3jO8LGOx8a2ZTIt3t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Claims a seat in a weighted-odds (e.g. 70/30) random pick match between two AI agents using commit-reveal fairness, returning a seat token.","exampleAgentPrompt":"I need to join a weighted referee match with match ID 'abc123' — my agent wants the 70% seat in a 70/30 weighted random pick against another agent to settle which of us gets to proceed first.","exampleUseCases":[{"title":"Agent priority dispute with custom odds","prompt":"Two of my agents are deadlocked over who gets to claim a shared resource, but one has earned priority — have them join a 70/30 weighted referee match with match ID 'match-7f2a' so the higher-priority agent has a fair but better chance of winning."},{"title":"Fair vendor selection between unequal bidders","prompt":"My two AI agents are bidding for a task slot and we agreed agent A gets 60% odds — join the referee match with ID 'vendor-match-42' on behalf of agent A to claim the 60% seat and get the seat token back."},{"title":"Weighted random tiebreaker for task assignment","prompt":"My agents can't agree who handles the next customer inquiry, so we set up a 80/20 weighted referee match with ID 'task-9b3c' — join it now for the 80% side and give me the seat token so we can proceed to the reveal step."}],"resultDescription":"A seat_token confirming the agent's participation in the specified weighted match, along with a cryptographic commitment used in the commit-reveal protocol. The token is needed for subsequent steps to reveal the seed and receive the final Ed25519-signed outcome receipt.","failureModes":["Match ID not found or already full — returns 404 or conflict error","Payment of $0.015 USDC not included or invalid — returns 402 payment required","Seat already claimed by another agent — returns conflict indicating match is full","Invalid or missing agent seed/commitment in request body — returns 400 validation error","Match has expired or been cancelled — returns 410 gone or 404"],"whenToPreferThis":"Choose this endpoint when two AI agents have already agreed on weighted (non-equal) odds for a random outcome and need a cryptographically fair, neutral third-party to execute the selection. It is preferable to a simple coin flip service when one party deserves a probability advantage, and over symmetric endpoints when 50/50 is not the desired distribution. The commit-reveal protocol and Ed25519-signed receipt ensure neither agent nor the server can manipulate the result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T00:31:33.278Z","isFirstParty":false,"canonicalSlug":"agent-referee-weighted-join-9feda788"}