{"uid":"cap_QkBwmk_jdqIZkT1Kp59iV","slug":"delx-seeded-balanced-groups-d17c3ce6","name":"Delx Seeded Balanced Groups","description":"Seeded Balanced Groups: Seeded Balanced Groups distributes items reproducibly across near-equal groups from bounded caller-supplied values without an external provider. Call Seeded Balanced Groups 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 Balanced Groups as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-…","url":"https://api.delx.ai/api/v1/x402/seeded-balanced-groups","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M4P-v8VvaLpwXbzXT8NFj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Deterministically partitions a list of integers into balanced groups using a reproducible seed string","exampleAgentPrompt":"Split the items [1,2,3,4,5,6,7] into 3 balanced groups using the seed 'my-agent-run-42' — I need the same grouping every time I run with that seed.","exampleUseCases":[{"title":"Deterministic agent task sharding","prompt":"I have 12 job IDs [1,2,3,4,5,6,7,8,9,10,11,12] and 4 worker agents. Split them into 4 balanced groups using seed 'batch-run-2024' so each run assigns the same jobs to the same workers."},{"title":"Reproducible A/B test bucket assignment","prompt":"Partition user IDs [101,102,103,104,105,106] into 2 balanced groups using seed 'ab-test-v3' so I can assign them consistently to control and treatment every time."},{"title":"Balanced tournament bracket seeding","prompt":"I have 8 players numbered 1 through 8 and need to split them into 2 balanced groups for the first round. Use seed 'tournament-spring' so the brackets are the same if I regenerate them."}],"resultDescription":"Returns a JSON object containing a 'groups' array of arrays, where each sub-array holds a balanced subset of the input integers. Also includes metadata: status ('pass'), schema version ('delx/util-seeded-balanced-groups/v1'), evidence fields confirming no data retention (retained: false), input SHA-256 hash for auditability, and external_calls count (0), plus an operation identifier.","failureModes":["Invalid or missing group_count may cause a 400 error or undefined partitioning behavior","Exceeding maxItems (256) on the items array may result in rejection","Very large seed strings near the 8192-character limit may be truncated or cause unexpected hashing","Non-integer values in the items array will fail schema validation","group_count larger than the number of items results in some groups being empty"],"whenToPreferThis":"Use this endpoint when you need a deterministic, reproducible, balanced partitioning of a list of integers using a seed — ideal for agent workflows requiring consistent task assignment across runs. Prefer it over random shuffling when reproducibility matters (e.g., retrying a failed batch should re-assign the same items). It processes everything in-memory with no retention, making it safe for sensitive ID lists. Choose this over a generic random split when auditability (via SHA-256 evidence) is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:14:52.685Z","isFirstParty":false}