{"uid":"cap_EWHuuxpQLpZn5APrz-bdw","slug":"list-shuffle-api-8919332b","name":"List Shuffle API","description":"Randomly reorder a caller-supplied list for fairness, games, experiments and randomized workflows.","url":"https://x402-zoo.lolagent.workers.dev/api/shuffle","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","required":["items"],"properties":{"items":{"type":"string"}}}},"additionalProperties":false}}},"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_oxYWwnOQEfslUIsue7xZ5","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":"Randomly reorders a caller-supplied list of items for fairness, games, experiments, or randomized workflows.","exampleAgentPrompt":"Shuffle this list of names randomly for me so we can pick a fair turn order: Alice, Bob, Carol, Dave, Eve.","exampleUseCases":[{"title":"Fair turn order for team standups","prompt":"I have a team standup and want to randomize who speaks first each day — shuffle this list: Alice, Bob, Carol, Dave, Eve, Frank."},{"title":"Raffle winner selection order","prompt":"We have 10 raffle participants and need to randomly order them to draw prizes fairly — shuffle this list: Tom, Sara, Mike, Jen, Leo, Nina, Raj, Amy, Chris, Dana."},{"title":"Randomize game player seating","prompt":"Can you randomly reorder these 6 players for their poker seating assignments: PlayerA, PlayerB, PlayerC, PlayerD, PlayerE, PlayerF?"}],"resultDescription":"Returns the caller-supplied list reordered in a random sequence, ensuring each item appears exactly once in an unpredictable new position. The response reflects a fair, stateless shuffle of the provided items.","failureModes":["Missing 'items' query parameter returns an error indicating required field is absent","Empty list or single-item list may return trivially (no meaningful shuffle)","Very long lists may hit query string length limits","Non-string or malformed input may result in parsing errors"],"whenToPreferThis":"Use this endpoint when you need a quick, stateless, pay-per-call random shuffle of a list without maintaining any server-side state or building your own randomization logic. Ideal for lightweight agent workflows needing fairness in ordering, game mechanics, or randomized assignments at minimal cost ($0.001 USDC per call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:03:35.178Z","isFirstParty":false}