# Solgiery Random Choice

> Solgiery Random Choice 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 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.

## Facts

- Endpoint: POST https://api.solgiery.com/v1/random/choice
- 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-choice-c258e409
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ytyg4dtnj6-_tuQ3VbaYT

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-choice-c258e409 -d '<json body>'
```

Example prompt: Randomly pick one item from this list using a cryptographically secure method: ['Alice', 'Bob', 'Charlie', 'Diana', 'Eve'].

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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-choice-c258e409/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)