{"uid":"cap_WOyKpQuCMEc-Uf5T3N7K7","slug":"provably-fair-multi-winner-picker-95061355","name":"Provably-Fair Multi-Winner Picker","description":"Provably-fair selection of N distinct winners from a list. ?candidates=a,b,c&count=2&round=1&client_seed=s&nonce=1","url":"https://pyfile-agent.taile3ff35.ts.net/data/fair/pick-many","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}}},"output":{"type":"object"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HVBNum2uUaFntnM09-fD2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Selects N distinct winners from a candidate list using a provably-fair, verifiable randomness scheme with a client seed and nonce.","exampleAgentPrompt":"Pick 3 distinct winners from this list — Alice, Bob, Carol, Dave, Eve — using round 1, client seed 'myseed42', and nonce 1, and make sure the selection is provably fair so anyone can verify it.","exampleUseCases":[{"title":"Multi-prize giveaway on social media","prompt":"I'm running a Twitter giveaway and need to pick 2 winners from these 8 entrants: tom, sara, jay, kim, leo, nia, raj, bea — use round 1, client seed 'twitterdraw2024', and nonce 1 so the result is publicly verifiable."},{"title":"Fantasy sports draft lottery","prompt":"For our fantasy league draft, randomly pick the top 4 teams in order from this list: TeamA, TeamB, TeamC, TeamD, TeamE, TeamF — run it as round 1 with client seed 'fantasyleague' and nonce 1 so everyone can verify the result is fair."},{"title":"Classroom random group assignment","prompt":"I need to fairly select 3 students out of my class roster — Anna, Ben, Clara, Diego, Elena, Finn — to present first tomorrow. Use round 1, client seed 'class101', nonce 1, and give me a verifiable proof of the draw."}],"resultDescription":"Returns an array of N distinct selected winners drawn from the candidate list, along with provenance data (round, client seed, nonce, and a verifiable hash or proof) so that any third party can reproduce and confirm the selection was not manipulated.","failureModes":["count exceeds number of candidates — cannot pick more winners than there are entries","missing required parameters (candidates, count, round, client_seed, nonce) — HTTP 400 bad request","candidates list is empty — returns error or empty result","duplicate candidates in input may affect distinctness guarantees","network timeout or server unavailability — HTTP 5xx"],"whenToPreferThis":"Choose this endpoint when you need to select multiple distinct winners (N > 1) from a list and require cryptographic verifiability — i.e., anyone can re-run the selection and confirm it matches using the same seed and nonce. Prefer the sibling single-winner endpoint when you only need one pick. Use this over a simple random shuffle when auditability and fairness proof matter, such as public contests, lotteries, or regulated draws.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:09:03.907Z","isFirstParty":false}