# Loyal Spark Prepare Transfer (Recipient API)

> Loyal Spark Prepare Transfer (Recipient API) is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Prepares an onchain token transfer for a loyalty rewards recipient on the Base Network via the Loyal Spark platform

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/recipient-api/prepare-transfer
- Price: $0.005/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-prepare-transfer-recipient-api-070f6205
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KbsV2ogQNt-0l3SM3wGxS

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-prepare-transfer-recipient-api-070f6205 -d '<json body>'
```

Example prompt: Prepare a loyalty token transfer for my customer on Loyal Spark — send them their earned rewards as a POST request with JSON body to the recipient API on Base network.

## When to prefer this

Use this endpoint when you need to programmatically prepare and initiate a loyalty token transfer to a recipient within the Loyal Spark onchain loyalty ecosystem on Base L2. Prefer this over manual wallet transfers when automating reward distribution as part of a business loyalty workflow or when an AI agent needs to handle post-purchase reward fulfillment.

## Known failure modes

- Missing required 'input' field returns validation error
- Invalid HTTP method (not POST/PUT/PATCH) causes rejection
- Malformed body type enum value fails schema validation
- Insufficient USDC payment (below $0.005) causes x402 payment failure
- Invalid or missing body object returns 400 error
- Network or Base L2 congestion may delay transfer preparation
- Unauthorized or unauthenticated request returns 401/403

## 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 a JSON response from the Loyal Spark recipient API containing transfer preparation details, likely including transaction parameters, recipient address, token amount, and status needed to complete the onchain loyalty reward transfer 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",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "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/loyal-spark-prepare-transfer-recipient-api-070f6205/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)