{"uid":"cap_ytyg4dtnj6-_tuQ3VbaYT","slug":"solgiery-random-choice-c258e409","name":"Solgiery Random Choice","description":"Uniformly select one original index and item from the input array. Equal values at different positions have separate chances. Uses the server OS CSPRNG. Returns consumed bytes for reproducible calculation, not proof of their origin. Price: 0.007 USDC per request, including the bounded batch.","url":"https://api.solgiery.com/v1/random/choice","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"items":{"type":"array","items":{},"maxItems":1000,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4-4bSxSSdK0QAgr8qKkf9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Uniformly selects one random index and item from an input array using a cryptographically secure PRNG (OS CSPRNG), with equal values at different positions each having an independent chance of selection.","exampleAgentPrompt":"Randomly pick one item from this list using a cryptographically secure method: ['Alice', 'Bob', 'Charlie', 'Diana', 'Eve'].","exampleUseCases":[{"title":"Random raffle winner selection","prompt":"I have a list of 50 raffle entrants — can you randomly pick one winner from the list using a cryptographically fair method? Here they are: ['John', 'Sarah', 'Mike', ...]"},{"title":"Daily random menu item picker","prompt":"Pick one dish at random from my restaurant's specials list for today's featured item: ['Grilled Salmon', 'Mushroom Risotto', 'Caesar Salad', 'Beef Tacos', 'Tomato Soup']."},{"title":"Random team assignment from roster","prompt":"Randomly select one person from our on-call roster to handle tonight's incident: ['Alex', 'Jordan', 'Taylor', 'Morgan', 'Casey']."}],"resultDescription":"Returns the selected item and its original index within the input array, along with the number of CSPRNG bytes consumed during selection (useful for reproducible calculation auditing). Each call produces an independent, uniformly random choice.","failureModes":["Array with fewer than 1 item returns a validation error","Array exceeding 1000 items is rejected","Malformed or missing 'items' field returns a 400 error","Payment not settled results in 402 response before processing","Network timeout before response is received"],"whenToPreferThis":"Use this endpoint when you need a single cryptographically secure random selection from an array of up to 1000 items, especially when fairness and unpredictability are important (e.g. raffles, lotteries, unbiased sampling). Prefer this over weighted choice endpoints when all items should have equal probability regardless of value. Choose this over client-side Math.random() when you need server-side CSPRNG guarantees and an auditable byte-consumption count.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:43:10.583Z","isFirstParty":false}