{"uid":"cap_kWHORxBRYUvzm28pzK-bz","slug":"delx-commerce-seeded-feature-bucket-2667d447","name":"Delx Commerce — Seeded Feature Bucket","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/seeded-feature-bucket?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"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_kl_IUaxh0Xx_AYbtx1OCs","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 assigns a seed+subject pair to a numbered bucket out of N, enabling stable feature flagging and A/B experiment assignment.","exampleAgentPrompt":"Use the seeded feature bucket API to assign user 'user_abc123' to one of 100 buckets, using experiment seed 'exp-launch-2024' — I need to know which bucket they land in for a rollout decision.","exampleUseCases":[{"title":"A/B test group assignment","prompt":"Assign customer 'cust_9982' to one of 4 experiment buckets using the seed 'checkout-flow-test' — I need a stable, deterministic bucket number so the same user always gets the same variant."},{"title":"Percentage-based feature rollout","prompt":"I'm rolling out a new feature to 10% of users. Can you use seed 'dark-mode-rollout' and subject 'user_00445' across 100 buckets to tell me if this user is in the first 10 buckets?"},{"title":"Traffic partitioning for canary deploy","prompt":"Split backend traffic for entity 'tenant_77' into one of 8 partitions using seed 'canary-v2-deploy' so I can route them consistently to the right server shard."}],"resultDescription":"Returns a JSON object containing the assigned bucket number (0-indexed integer), the total bucket count, operation name, status ('pass'), and an evidence record including whether input was retained (always false), the SHA-256 hash of the input, and the number of external calls made (always 0). This allows verifiable, auditable bucket assignment.","failureModes":["Missing or invalid seed/subject strings may result in a 400 error","bucket_count of 0 or negative integer will likely cause a computation error","Exceeding maxLength of 8192 characters on seed or subject fields will be rejected","Payment failure (insufficient USDC balance) results in a 402 response before computation","Network timeout if Base/Solana payment settlement is slow"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible bucket assignment without storing any user data server-side — ideal for privacy-sensitive feature flagging. Its verifiable evidence record (SHA-256 input hash, zero external calls, no retention) makes it auditable. Prefer it over homegrown hashing when you need a pay-per-call model with no API key signup friction, or when operating in an agent workflow that requires on-chain payment (USDC via x402 on Base or Solana).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:41:08.129Z","isFirstParty":false,"canonicalSlug":"delx-commerce-seeded-feature-bucket-2667d447"}