# Delx Seeded Shuffle

> Delx Seeded Shuffle is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Deterministically shuffles a list of items using a provided seed string, returning a reproducible permutation in memory without retaining input data.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/seeded-shuffle
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-seeded-shuffle-86659d17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P70YI_0eist03Rdz05LHe

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 delx-seeded-shuffle-86659d17 -d '<json body>'
```

Example prompt: Shuffle this list — ["apple", "banana", "cherry", "date"] — using the seed "abc123" and give me back the reordered items.

## When to prefer this

Choose this endpoint when you need a deterministic, reproducible shuffle — i.e., the same seed and list must always produce the same output. It is ideal for agent workflows requiring auditability (the evidence block confirms no retention and provides an input hash), reproducible randomization in A/B testing, session-consistent orderings, or any scenario where true randomness would break reproducibility. Prefer it over client-side shuffles when you need a signed, auditable, in-memory-only guarantee with no external side effects.

## Known failure modes

- Items array exceeds 256 entries — request rejected
- Individual item string exceeds 8192 characters — validation error
- Seed string exceeds 8192 characters — validation error
- Missing required fields (seed or items) — schema validation error
- Network timeout on the API call — no result returned
- Invalid JSON body — parse error response

## How this service works

Seeded Shuffle: Seeded Shuffle produces a reproducible permutation of caller items from bounded caller-supplied values without an external provider. Call Seeded Shuffle when an agent needs a reproducible decision that another run can independently replay. Returns the deterministic selection plus seed provenance, population bounds, and the operation-specific outcome for Seeded Shuffle as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-party, stateless, memory-only execut…

## Output

Returns a JSON object containing the shuffled array of items, the total count, a schema identifier, a pass/fail status, and an evidence block that confirms no data was retained, provides a SHA-256 hash of the input for auditability, and notes that zero external calls were made.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "string",
   "maxLength": 8192,
   "description": "Seed supplied to Seeded Shuffle; used only for this bounded calculation and processed in memory without retention."
  },
  "items": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 8192
   },
   "maxItems": 256,
   "description": "Items supplied to Seeded Shuffle; used only for this bounded calculation and processed in memory without retention."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "count": 4,
   "items": [
    "c",
    "d",
    "a",
    "b"
   ]
  },
  "schema": "delx/util-seeded-shuffle/v1",
  "status": "pass",
  "evidence": {
   "retained": false,
   "input_sha256": "b0b0f77561c04919df180b7c85f4087b8944df4491dda150370c45e90452cad7",
   "external_calls": 0
  },
  "operation": "seeded_decision:seeded_shuffle"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-seeded-shuffle-86659d17/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)