# Delx Loyalty Reward Quote

> Delx Loyalty Reward Quote 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).

Calculates loyalty points earned, reward value, effective rebate, and generates a ledger-ready idempotent credit instruction for a given purchase event

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/loyalty-reward-quote
- 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-loyalty-reward-quote-e28e3562
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CUVgMe1LzifKrADEyRZnP

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-loyalty-reward-quote-e28e3562 -d '<json body>'
```

Example prompt: Calculate the loyalty reward quote for a $75.00 USD purchase with a tier multiplier of 1.5, 10 bonus points, and a redemption value of $0.01 per point — the event ID is 'order-abc-123'.

## When to prefer this

Choose this endpoint when you need a single, authoritative, idempotent computation of loyalty points and reward value for a purchase event — especially when you need a ledger-ready credit instruction that can be safely replayed. Prefer this over manual calculations when tier multipliers, bonus points, and custom redemption rates all need to be factored together in one consistent pass. Ideal for e-commerce checkout flows, post-transaction loyalty crediting pipelines, and finance reporting where double-crediting risk must be eliminated via event_id idempotency.

## Known failure modes

- purchase_amount below minimum (0) returns validation error
- invalid currency code (not 3 characters) returns 400
- tier_multiplier or points_per_unit set to 0 produces zero-point result
- missing required purchase_amount field returns 422 unprocessable entity
- duplicate event_id may be used for idempotency — same response returned without recalculation
- network timeout at $0.001 USDC payment layer returns 402 before compute

## How this service works

Calculate loyalty points, reward value, effective rebate, and a ledger-ready idempotent credit instruction for $0.001 USDC.

## Output

Returns calculated loyalty points earned for the purchase, the monetary reward value, the effective rebate rate, and a ledger-ready idempotent credit instruction that can be directly applied to a loyalty account ledger without risk of double-crediting.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "currency": {
   "type": "string",
   "default": "USD",
   "maxLength": 3,
   "minLength": 3
  },
  "event_id": {
   "type": "string"
  },
  "bonus_points": {
   "type": "integer",
   "default": 0,
   "minimum": 0
  },
  "points_per_unit": {
   "type": "number",
   "default": 1,
   "minimum": 0
  },
  "purchase_amount": {
   "type": "number",
   "minimum": 0
  },
  "tier_multiplier": {
   "type": "number",
   "default": 1,
   "minimum": 0
  },
  "redemption_value_per_point": {
   "type": "number",
   "default": 0.01,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "currency": "USD",
   "base_points": 99,
   "total_points": 158,
   "purchase_amount": "49.99",
   "ledger_instruction": {
    "unit": "points",
    "amount": 158,
    "event_id": "order-123",
    "operation": "credit",
    "idempotency_required": true
   },
   "effective_rebate_pct": "3.16",
   "stores_customer_state": false,
   "estimated_reward_value": "1.580000"
  },
  "tool_name": "util_loyalty_reward_quote"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-loyalty-reward-quote-e28e3562/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)