# Delx Seeded Feature Bucket

> Delx Seeded Feature Bucket 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 assigns a seed+subject pair to a numbered bucket for feature flagging and A/B test bucketing.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/seeded-feature-bucket
- 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-feature-bucket-f69a72c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i2h7GO4pq_qaauF5uyFo6

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-feature-bucket-f69a72c7 -d '<json body>'
```

Example prompt: Using seed 'experiment-2024-launch' and bucket count 100, which bucket does user ID 'user_abc123' fall into for my feature rollout?

## When to prefer this

Use this endpoint when you need stateless, deterministic, reproducible bucket assignment for feature flags, A/B tests, or canary rollouts — especially when you need an audit trail (input hash, no retention guarantee) and cannot tolerate side effects. Prefer it over custom hashing when you want a governed, evidence-backed computation with consistent results across agent calls.

## Known failure modes

- Missing required fields (seed, subject, or bucket_count) results in a validation error
- bucket_count of 0 or negative may cause a division error
- Strings exceeding 8192 characters will be rejected
- Malformed JSON body returns a 400-level error

## How this service works

Seeded Feature Bucket: Seeded Feature Bucket maps a stable subject to an integer feature bucket from bounded caller-supplied values without an external provider. Call Seeded Feature Bucket 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 Feature Bucket as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. First-party, st…

## Output

Returns a JSON object with the assigned bucket index (0-based integer), the total bucket count, operation name, a pass status, and an evidence block confirming no data was retained and no external calls were made, plus an SHA-256 hash of the input for audit purposes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "seed": {
   "type": "string",
   "maxLength": 8192,
   "description": "Seed supplied to Seeded Feature Bucket; used only for this bounded calculation and processed in memory without retention."
  },
  "subject": {
   "type": "string",
   "maxLength": 8192,
   "description": "Subject supplied to Seeded Feature Bucket; used only for this bounded calculation and processed in memory without retention."
  },
  "bucket_count": {
   "type": "integer",
   "description": "Bucket Count supplied to Seeded Feature Bucket; used only for this bounded calculation and processed in memory without retention."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "bucket": 96,
   "bucket_count": 100
  },
  "schema": "delx/util-seeded-feature-bucket/v1",
  "status": "pass",
  "evidence": {
   "retained": false,
   "input_sha256": "986a6fbe5cafd1cbc5f04ad6ed4a1f0314e97558cccc32a4843ec91f83e97521",
   "external_calls": 0
  },
  "operation": "seeded_decision:seeded_feature_bucket"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-seeded-feature-bucket-f69a72c7/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)
