# Loyal Spark - List My Loyalty Balances

> Loyal Spark - List My Loyalty Balances 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-14).

Retrieves the current ERC-20 loyalty token balances held by the authenticated user across all programs on the Loyal Spark onchain protocol (Base L2).

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/list_my_loyalty_balances
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-list-my-loyalty-balances-32002455
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mr65x74ElGfnlLFRrNVMy

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-my-loyalty-balances-32002455 -d '<json body>'
```

Example prompt: Show me all my current loyalty token balances across every program on Loyal Spark — I want to see what I've earned and what I can redeem.

## When to prefer this

Use this endpoint when an AI agent or user needs to audit their current loyalty token holdings across all Loyal Spark programs on Base L2. Prefer this over general blockchain balance queries when the context is specifically about loyalty rewards earned through Loyal Spark merchants or campaigns, and when the goal is to decide what to redeem or trade P2P.

## Known failure modes

- Unauthenticated or missing wallet identity returns 401/403
- No loyalty balances found returns empty list or 404
- Payment of $0.01 USDC not provided returns x402 payment required error
- Onchain RPC node unavailable causes timeout or 503
- Invalid wallet address format returns 400 bad request

## 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 response listing the caller's loyalty token balances across all enrolled Loyal Spark programs, including token amounts, ERC-20 token identifiers, and program names on Base L2.

## 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-my-loyalty-balances-32002455/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)