# Delx Commerce — Seeded Balanced Groups

> Delx Commerce — Seeded Balanced Groups is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Deterministically splits a list of integers into balanced groups using a seed for reproducible, verifiable partitioning.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/seeded-balanced-groups?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-seeded-balanced-groups-a1930df2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-VlCTU7k1rqosLsqqAGi9

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-commerce-seeded-balanced-groups-a1930df2 -d '<json body>'
```

Example prompt: Split the items [1, 2, 3, 4, 5, 6, 7] into 3 balanced groups using the seed 'experiment-42' — I need the same grouping every time I run it.

## When to prefer this

Choose this endpoint when you need deterministic, reproducible, verifiable partitioning of integer IDs or indices into balanced groups — especially when auditability matters (the SHA-256 input hash and no-retention evidence make the result verifiable). It is ideal for agents that need fair assignment (teams, workloads, experiment buckets) where the same seed must always produce the same split. It is not suitable for partitioning non-integer items or when you need weighted/unbalanced groups.

## Known failure modes

- Invalid or missing group_count (e.g. zero or negative) may cause an error response
- Exceeding the 256-item limit on the items array will be rejected
- Seed string exceeding 8192 characters will be rejected
- Non-integer values in the items array will fail schema validation
- Payment failure via x402 will prevent the computation from running

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a JSON object containing: groups (an array of arrays, each holding the integer items assigned to that group), the operation schema identifier, a status of 'pass', and an evidence object with a SHA-256 hash of the input, a flag confirming no data was retained, and a count of external calls made (always 0). The result is deterministic for a given seed and input.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "groups": [
    [
     3,
     6,
     5
    ],
    [
     2,
     1
    ],
    [
     7,
     4
    ]
   ]
  },
  "schema": "delx/util-seeded-balanced-groups/v1",
  "status": "pass",
  "evidence": {
   "retained": false,
   "input_sha256": "5e73677b9e39056c1e2a57b5393da0a22a4c5722d878e5d471fb8ea36275c80d",
   "external_calls": 0
  },
  "operation": "seeded_decision:seeded_balanced_groups"
 }
}
```

## More

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