{"uid":"cap_6FLqArsORr5VgZf6w80iA","slug":"delx-commerce-seeded-winners-without-replacement-5653e7d5","name":"Delx Commerce — Seeded Winners Without Replacement","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/seeded-winners-without-replacement?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"seed":{"type":"string","maxLength":8192,"description":"Seed supplied to Seeded Winners Without Replacement; used only for this bounded calculation and processed in memory without retention."},"candidates":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":256,"description":"Candidates supplied to Seeded Winners Without Replacement; used only for this bounded calculation and processed in memory without retention."},"winner_count":{"type":"integer","description":"Winner Count supplied to Seeded Winners Without Replacement; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"count":3,"winners":["d","c","b"],"monetary_claim":false},"schema":"delx/util-seeded-winners-without-replacement/v1","status":"pass","evidence":{"retained":false,"input_sha256":"7854633a204eec63fedb89d8b9c7942b2651237bdee78ebb4e3b8378e7a3d424","external_calls":0},"operation":"seeded_decision:seeded_winners_without_replacement"}},"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_BqfnqLyiqQb2utZxRjlJc","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":"Deterministically selects a specified number of winners from a candidate list using a seed, with no replacement, and returns verifiable evidence of the selection.","exampleAgentPrompt":"Pick 3 winners from this list of entrants — ['Alice','Bob','Carol','Dave','Eve','Frank'] — using the seed 'summer2025', making sure no one is picked twice, and give me proof the selection was fair.","exampleUseCases":[{"title":"Raffle winner selection for giveaway","prompt":"I have 50 contest entrants and need to pick 5 winners fairly — use the seed 'contest-july-4' to select from ['Ana','Ben','Cleo','Dan','Eli','Faye','Gio','Hana','Ivan','Jess','Kai','Lena','Max','Nora','Omar','Pam','Quinn','Rosa','Sam','Tina','Uma','Vic','Wren','Xena','Yuki','Zane','Amir','Bea','Cole','Dani','Ed','Fran','Greg','Hope','Ike','Jade','Kent','Lily','Moe','Nina','Otto','Petra','Rex','Sue','Tom','Ursa','Val','Walt','Xio','Yen','Zoe'] and give me verifiable evidence of the draw."},{"title":"Reproducible A/B test group assignment","prompt":"Assign 4 participants from ['User1','User2','User3','User4','User5','User6','User7','User8'] to a treatment group using seed 'ab-test-run-42', no repeats, and show me the audit hash so I can verify the result later."},{"title":"Rotating on-call schedule slot selection","prompt":"From our on-call pool ['Alice','Bob','Carol','Dave','Eve'], pick 2 people for this week's coverage using the seed 'week-2025-28' and confirm no one is selected twice."}],"resultDescription":"Returns a JSON object containing the list of selected winners, the count of winners, a SHA-256 hash of the input for auditability, confirmation that no data was retained, the number of external calls made (always 0), and a monetary_claim flag. The schema identifier and operation name are also included for traceability.","failureModes":["winner_count exceeds the number of candidates — server returns an error since you cannot pick more unique winners than available candidates","invalid or missing seed — may result in a 400 bad request","candidates array exceeds 256 items — rejected by schema validation","payment not included or insufficient USDC — returns HTTP 402 Payment Required","malformed JSON body — returns 400 or 422 validation error"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, reproducible, and auditable random selection of winners from a candidate list — especially when fairness verification matters (e.g. giveaways, lotteries, A/B test assignments). The seeded approach means the same seed + candidates always yields the same winners, enabling independent verification. Prefer this over a local RNG when you need an immutable SHA-256 input hash as evidence of what was submitted. The pay-per-result, no-signup model makes it ideal for agent workflows that need occasional, trustless random selection without managing credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:54:08.188Z","isFirstParty":false,"canonicalSlug":"delx-commerce-seeded-winners-without-replacement-5653e7d5"}