# Loyal Spark x402 Transfer Gateway

> Loyal Spark x402 Transfer Gateway 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).

Executes an HTTP transfer action (POST/PUT/PATCH) through Loyal Spark's onchain loyalty platform on Base Network via the x402 payment protocol

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/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-x402-transfer-gateway-ca1ff100
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7OpI9lm7NpqS17zrapZue

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-x402-transfer-gateway-ca1ff100 -d '<json body>'
```

Example prompt: Use Loyal Spark's onchain gateway to transfer loyalty reward tokens to customer wallet 0xABC...123 for their recent purchase — POST the transfer with JSON body to the x402 gateway on Base Network.

## When to prefer this

Use this endpoint when you need to programmatically execute loyalty token transfers or reward distributions on the Loyal Spark platform via the x402 micropayment protocol on Base Network. Prefer this over generic blockchain transfer endpoints when the goal is specifically issuing, redeeming, or routing branded ERC-20 loyalty rewards through an AI-agent-compatible gateway with built-in x402 payment handling.

## Known failure modes

- Invalid or missing required fields (type, method, bodyType, body) returns 400 validation error
- Insufficient x402 payment (underpayment of $0.005 USDC) results in 402 Payment Required
- Invalid HTTP method (not POST/PUT/PATCH) returns schema validation error
- Malformed JSON body causes parsing failure
- Network or Base chain congestion causing delayed transaction confirmation
- Unauthorized wallet or missing authentication headers returning 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 Loyal Spark's agent-api or recipient-api confirming the transfer action result, including transaction status and any relevant onchain data for the executed loyalty reward operation.

## 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-x402-transfer-gateway-ca1ff100/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)
