# Loyal Spark Create Personalized Offer

> Loyal Spark Create Personalized Offer is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Generates an AI-driven personalized loyalty offer for a specific customer based on their onchain activity and preferences on the Loyal Spark Base L2 protocol.

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/mcp-tools/create_personalized_offer
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-create-personalized-offer-b057e5ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cK_SKPynFe6VAE0DV7rPc

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 loyal-spark-create-personalized-offer-b057e5ab -d '<json body>'
```

Example prompt: Using Loyal Spark, create a personalized loyalty offer for wallet 0xABC123 in my rewards program 'CoffeeClub' — give them 50 SPARK tokens if they make 3 purchases this week, valid for 7 days.

## When to prefer this

Choose this endpoint when you need to generate AI-personalized, onchain loyalty offers for individual customers within the Loyal Spark protocol on Base L2, especially when automating reward campaigns via AI agents or MCP tooling. Prefer this over generic offer creation when personalization based on customer wallet history and behavior is required.

## Known failure modes

- Invalid or missing wallet address returns 400 Bad Request
- Unknown loyalty program ID returns 404 Not Found
- Insufficient offer parameters returns 422 Unprocessable Entity
- Payment of $0.01 USDC not received returns 402 Payment Required
- Rate limiting or quota exceeded returns 429 Too Many Requests
- Base L2 network congestion may cause delayed offer creation

## How this service works

Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.

## Output

Returns a JSON object containing the generated personalized offer details including a unique offer ID, the targeted wallet address, reward token amount, qualifying conditions, activation status, and offer expiry timestamp on the Loyal Spark Base L2 protocol.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "toolName",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "mcp"
    },
    "example": {
     "type": "object"
    },
    "toolName": {
     "type": "string"
    },
    "transport": {
     "enum": [
      "streamable-http",
      "sse"
     ],
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/loyal-spark-create-personalized-offer-b057e5ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.loyalspark.online](https://www.zero.xyz/host/api.loyalspark.online/llms.txt)