{
  "format": "delx/intent-card/v1",
  "id": "loyalty-reward-quote-api",
  "intent": "quote loyalty points for a purchase amount",
  "title": "Loyalty reward quote API for agents",
  "description": "Compute a deterministic loyalty-points quote for $0.001 from purchase amount and multipliers—no wallet ledger or payout rail.",
  "keywords": [
    "loyalty points API",
    "rewards quote API",
    "points calculator",
    "loyalty workflow for agents",
    "x402 loyalty"
  ],
  "updated_at": "2026-08-06",
  "canonical_url": "https://commerce.delx.ai/intents/loyalty-reward-quote-api",
  "machine_url": "https://commerce.delx.ai/intents/loyalty-reward-quote-api.json",
  "recommendation": {
    "tool_name": "util_loyalty_reward_quote",
    "service_name": "Delx Loyalty Reward Quote",
    "method": "POST",
    "resource": "https://api.delx.ai/api/v1/x402/loyalty-reward-quote",
    "price_usdc": "0.001",
    "payment_protocols": [
      "x402",
      "mpp"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "purchase_amount": {
          "type": "number",
          "minimum": 0,
          "description": "Eligible purchase amount."
        },
        "currency": {
          "type": "string",
          "minLength": 3,
          "maxLength": 3,
          "default": "USD"
        },
        "points_per_unit": {
          "type": "number",
          "minimum": 0,
          "default": 1
        },
        "tier_multiplier": {
          "type": "number",
          "minimum": 0,
          "default": 1
        },
        "bonus_points": {
          "type": "integer",
          "minimum": 0,
          "default": 0
        },
        "redemption_value_per_point": {
          "type": "number",
          "minimum": 0,
          "default": 0.01
        },
        "event_id": {
          "type": "string",
          "description": "Optional caller-owned idempotency identifier for the downstream ledger."
        }
      },
      "required": [
        "purchase_amount"
      ],
      "additionalProperties": false
    },
    "example_input": {
      "purchase_amount": 49.99,
      "currency": "USD",
      "points_per_unit": 2,
      "tier_multiplier": 1.5,
      "bonus_points": 10,
      "event_id": "order-123"
    },
    "example_output": {
      "tool_name": "util_loyalty_reward_quote",
      "result": {
        "purchase_amount": "49.99",
        "currency": "USD",
        "base_points": 99,
        "total_points": 158,
        "estimated_reward_value": "1.580000",
        "effective_rebate_pct": "3.16",
        "stores_customer_state": false,
        "ledger_instruction": {
          "event_id": "order-123",
          "operation": "credit",
          "amount": 158,
          "unit": "points",
          "idempotency_required": true
        }
      }
    },
    "agentcash": {
      "buy": "npx agentcash@latest fetch https://api.delx.ai/api/v1/x402/loyalty-reward-quote -m POST -H 'x-delx-source: intent-card-loyalty-reward-quote-api' --max-amount 0.001 -b '{\"purchase_amount\":49.99,\"currency\":\"USD\",\"points_per_unit\":2,\"tier_multiplier\":1.5,\"bonus_points\":10,\"event_id\":\"order-123\"}'",
      "max_amount_usdc": "0.001"
    }
  },
  "attribution": {
    "header": "x-delx-source",
    "value": "intent-card-loyalty-reward-quote-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/loyalty-reward-quote"
  }
}