# Loyal Spark API — Balance

> Loyal Spark API — 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-14).

Retrieves the current balance for a loyalty account via the Loyal Spark x402-gated API

## Facts

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

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-8fd29b72
```

Example prompt: Can you check the current balance on my Loyal Spark loyalty account?

## When to prefer this

Use this endpoint when you need to retrieve the current balance for a loyalty account on the Loyal Spark platform. Prefer this over recipient-api/balance or recipient-api/balances if you are acting as the primary account holder rather than a recipient, or if you need a single unified balance read via the x402-gated gateway.

## Known failure modes

- 401/402 Unauthorized if payment or auth headers are missing
- 404 if account not found
- 500 internal server error if Loyal Spark backend is unavailable
- Empty or zero balance returned for new accounts
- Rate limiting errors if too many requests are made in quick succession

## 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 balance for the loyalty account, likely including points or currency balance details associated with the authenticated 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-8fd29b72/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)