{
  "format": "delx/intent-card/v1",
  "id": "weighted-choice-api",
  "intent": "Weighted Choice for an agent workflow",
  "title": "Weighted Choice API for agents",
  "description": "Pick one item from a list using non-negative weights — first-party local utility for agent preflight and proven micro-utils expansion. Returns deterministic machine-readable JSON for $0.001 USDC via x402 on Base. Execution is first-party, local-only, stateless, and memory-only with no paid upstream, no input retention, no web search, no live RPC, and no mediagen. Results are advisory; the caller owns authorization, budgets, and production controls. Sibling of Delx routes that already converted externally (random, hash, URL, FX families).",
  "keywords": [
    "Weighted Choice API",
    "Weighted Choice for agents",
    "pay per result API",
    "x402 API",
    "no API key"
  ],
  "updated_at": "2026-08-07",
  "canonical_url": "https://commerce.delx.ai/intents/weighted-choice-api",
  "machine_url": "https://commerce.delx.ai/intents/weighted-choice-api.json",
  "recommendation": {
    "tool_name": "util_weighted_choice",
    "service_name": "Delx Weighted Choice",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/weighted-choice",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "items": {
          "description": "Input field: items.",
          "type": "array"
        },
        "weights": {
          "description": "Input field: weights.",
          "type": "array"
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": true
    },
    "example_input": {
      "items": [
        "a",
        "b",
        "c"
      ],
      "weights": [
        1,
        2,
        1
      ]
    },
    "example_output": {
      "schema": "delx/util-weighted-choice/v1",
      "ok": true,
      "choice": "c",
      "index": 2,
      "weight": 1,
      "total_weight": 4,
      "probability": 0.25
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/weighted-choice -m POST -H 'x-delx-source: intent-card-weighted-choice-api' --max-amount 0.001 -b '{\"items\":[\"a\",\"b\",\"c\"],\"weights\":[1,2,1]}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-weighted-choice-api"
  },
  "evidence": {
    "paid_openapi": "https://api.delx.ai/openapi.x402.json",
    "governed_portfolio": "https://api.delx.ai/x402-portfolio.json",
    "live_contract": "https://api.delx.ai/api/v1/x402/weighted-choice"
  }
}