# Loyal Spark Recipient API – Single Balance

> Loyal Spark Recipient API – Single Balance is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-16).

Retrieves the loyalty balance for the currently authenticated recipient from the Loyal Spark platform

## Facts

- Endpoint: GET https://api.loyalspark.online/x402-gateway/recipient-api/balance
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-loyalspark-online-0414f473
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LyvRDTEpZCRRZtMqfBhgO

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 api-loyalspark-online-0414f473
```

Example prompt: What's my current loyalty points balance on Loyal Spark right now?

## When to prefer this

Use this endpoint when you need to check the current loyalty balance for a single authenticated recipient on the Loyal Spark platform. Prefer this over the recipient-api/balances endpoint when you only need the individual caller's balance rather than a list of balances across multiple recipients or accounts.

## Known failure modes

- 401 Unauthorized if authentication token is missing or invalid
- 404 if recipient account not found
- 402 Payment Required if the $0.001 USDC micropayment is not included
- 500 server error if the Loyal Spark backend is unavailable
- Empty or zero balance returned if the recipient has no accumulated points

## How this service works

Onchain loyalty platform on Base Network. Businesses launch branded rewards in minutes, customers earn real value with every purchase, and AI agents automate the rest via REST and MCP. Free plan mints up to 1,000 tokens per month; every call is scoped by row-level security to the wallet behind the API key. 16 skill guides at loyalspark.online/.well-known/skills/index.md.

## Output

Returns the current loyalty balance for the authenticated recipient, including points totals or reward credit available in their account.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  },
  "inputSchema": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
 },
 "description": "JSON from Loyal Spark agent-api or recipient-api. See OpenAPI for response shape."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-loyalspark-online-0414f473/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)