{"uid":"cap_4TjNxHHDzY6jD5lcTgIZ3","slug":"delx-commerce-seeded-percentage-rollout-056fdb2d","name":"Delx Commerce — Seeded Percentage Rollout","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-percentage-rollout?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"seed":{"type":"string","maxLength":8192,"description":"Seed supplied to Seeded Percentage Rollout; used only for this bounded calculation and processed in memory without retention."},"subject":{"type":"string","maxLength":8192,"description":"Subject supplied to Seeded Percentage Rollout; used only for this bounded calculation and processed in memory without retention."},"percentage":{"type":"number","description":"Percentage supplied to Seeded Percentage Rollout; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"included":false,"bucket_percent":18.47354188710196},"schema":"delx/util-seeded-percentage-rollout/v1","status":"pass","evidence":{"retained":false,"input_sha256":"81678a13647db7a4f1b151b8288397c3c5f872a52bed79342f44fc6eb2ea00fe","external_calls":0},"operation":"seeded_decision:seeded_percentage_rollout"}},"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_HQ3kaxDzFTy651365kydo","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 decides whether a subject falls within a percentage rollout based on a seed and threshold, returning a boolean inclusion result and bucket percentage.","exampleAgentPrompt":"Check if user ID 'user_abc123' is included in a 20% rollout using 'feature-dark-mode-v2' as the seed.","exampleUseCases":[{"title":"Gradual feature flag rollout","prompt":"Is user 'usr_98f2a' in the 15% rollout for the new checkout flow? Use 'checkout-v3-rollout' as the seed."},{"title":"A/B test group assignment","prompt":"For my experiment named 'homepage-redesign-test', check whether subject 'session_4412' falls into the 50% treatment group."},{"title":"Canary deployment targeting","prompt":"Using seed 'canary-api-v4', tell me if device ID 'dev_00771' qualifies for the 5% canary release."}],"resultDescription":"Returns a JSON object containing: `included` (boolean indicating if the subject falls within the percentage), `bucket_percent` (the computed hash percentage for the subject), `status` ('pass'), and an `evidence` block with `retained: false`, `input_sha256` (hash of inputs for verifiability), and `external_calls: 0` — confirming the computation was local and stateless.","failureModes":["Missing required fields (seed, subject, or percentage) returns a validation error","Percentage out of 0–100 range may return an error or unexpected behavior","Payment failure via x402 protocol results in 402 response before computation occurs","Malformed input types (non-numeric percentage) cause schema validation failure"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, reproducible, and verifiable percentage-based bucketing decision — especially in agent workflows where auditability matters (evidence hash provided). Prefer over home-rolled hash logic when you need pay-per-use, no-signup access with cryptographic proof of computation. Ideal for gradual rollouts, feature flags, or A/B assignment where the same seed+subject pair must always produce the same result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:53:59.935Z","isFirstParty":false,"canonicalSlug":"delx-commerce-seeded-percentage-rollout-056fdb2d"}