# Solgiery Random Shuffle

> Solgiery Random Shuffle is a paid API for AI agents from api.solgiery.com, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-14).

Uniformly shuffles an array of up to 1000 items using a server-side CSPRNG, returning each original index and item exactly once in a random permutation.

## Facts

- Endpoint: POST https://api.solgiery.com/v1/random/shuffle
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solgiery-random-shuffle-829e0efc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3IdTxrHhqaVjeINWAARkW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability solgiery-random-shuffle-829e0efc -d '<json body>'
```

Example prompt: Can you randomly shuffle this list of 20 participant names for me using a cryptographically secure randomizer: [Alice, Bob, Carol, Dave, Eve, Frank, Grace, Heidi, Ivan, Judy, Kevin, Leo, Mallory, Nancy, Oscar, Peggy, Quinn, Rob, Sybil, Trent]?

## When to prefer this

Choose this endpoint when you need a cryptographically secure, uniform random permutation of an array of up to 1000 items, especially when auditability of randomness (via consumed CSPRNG bytes) matters. Prefer it over client-side shuffles when trust and verifiability of randomness are important, such as in lotteries, game mechanics, or anonymized data ordering. It is distinct from sampling endpoints (which select subsets) and weighted-choice endpoints.

## Known failure modes

- Array with fewer than 1 item or more than 1000 items returns a validation error
- Non-array input triggers a schema validation error
- Payment not settled via x402 results in a 402 Payment Required response
- Network timeout on large arrays near the 1000-item limit
- Server CSPRNG unavailability causes a 500 error

## How this service works

Uniformly permute all input items. Returns each original index and its item exactly once; equal values remain distinct positions. 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.

## Output

Returns a permutation of the input array where each element appears exactly once, paired with its original index. Also includes the number of CSPRNG bytes consumed during the shuffle, enabling reproducible byte-count calculation. The shuffle is uniform across all possible permutations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "items": {
   "type": "array",
   "items": {},
   "maxItems": 1000,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solgiery-random-shuffle-829e0efc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solgiery.com](https://www.zero.xyz/host/api.solgiery.com/llms.txt)