# Loyal Spark - List Loyalty Programs

> Loyal Spark - List Loyalty Programs 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).

Retrieves a list of all onchain loyalty programs available on the Loyal Spark protocol deployed on Base L2

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/mcp-tools/list_loyalty_programs
- 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-list-loyalty-programs-edb4061b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TbCNWzpL_Oi2B6BRRGq36

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-list-loyalty-programs-edb4061b -d '<json body>'
```

Example prompt: Can you show me all the loyalty reward programs currently available on Loyal Spark on Base so I can pick one to join and start earning tokens?

## When to prefer this

Use this endpoint when you need to discover and enumerate all available loyalty programs on the Loyal Spark protocol before performing operations like earning, redeeming, or trading loyalty tokens. Prefer this over blockchain direct queries when you want structured metadata about programs rather than raw contract data.

## Known failure modes

- No programs found — returns empty list if no programs are active
- Authentication failure — missing or invalid x402 payment header returns 402 error
- Network error — Base L2 RPC unavailability may cause timeout or 503
- Invalid request body — malformed POST parameters return 400 error
- Rate limiting — excessive calls may return 429 too many requests

## 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

A JSON list of onchain loyalty programs available on the Loyal Spark protocol, including program names, ERC-20 token details, reward structures, redemption options, and program metadata such as merchant info and P2P trading availability.

## Example request

```json
{
 "id": 1,
 "method": "tools/call",
 "params": {
  "name": "get_platform_info",
  "arguments": {}
 },
 "jsonrpc": "2.0"
}
```

## 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-list-loyalty-programs-edb4061b/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)