Loyal Spark

active

Onchain Loyalty Protocol on Base

Loyal Spark is an onchain loyalty-as-a-service protocol on Base L2. AI agents and merchants can create B20 loyalty programs (legacy ERC-20 optional), mint tokens to customer wallets, manage reward catalogs, trade tokens on a P2P escrow marketplace, redeem rewards for vouchers, and run analytics — all via paid x402 endpoints (USDC on Base) or via standard REST with x-api-key. Coverage: 89 paid…

AIBasex402 v2exactloyalspark.online ↗︎

Settled via Coinbase.

Transactions · 30d
5,929
Volume · 30d
$32.01
Unique buyers · 30d
100
Uptime · 30d
98.7%
Latency p50
221ms
Reported calls · 30d
3,084

Endpoints (123 live)

  • POST /x402-gateway/mcp-tools/earn_points — Calculate and mint loyalty tokens from a purchase amount using the program cashback rate (earn / cashback flow). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: lsk_... (or Authorization: Bearer lsk_...) with the payment; without a live key you are not charged. Docs: loyalspark.online/for-agents (0.01 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/get_my_loyalty_balance — Balance and tier for one loyalty program token held by the authenticated recipient wallet. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/list_p2p_offers — List open peer-to-peer token swap offers; optional filter by loyalty token (same price band as merchant GET /offers). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Payment alone gives access; do not send an API key. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/list_my_vouchers — Loyalty rewards: List vouchers issued to your wallet (active, used, expired) across enrolled loyalty programs. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/redeem_my_reward — Redeem a reward into an active voucher after paying the token cost on-chain (requires transfer tx hash). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.01 USDC on Base)
  • POST /x402-gateway/mcp-tools/mint_loyalty_tokens — Loyalty rewards: Fee-first mint calls[] (protocol fee first, then recipient) + fee_obligation_id. Accepts 0x Base wallet or customer email in recipient_address (or recipient_email). Confirm with confirm_mint_fee. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: lsk_... (or Authorization: Bearer lsk_.... (0.01 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/list_my_gift_certificates — Loyalty rewards: List gift certificates claimed by your wallet with optional status filter. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.01 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/list_rewards_for_program — List active rewards you can redeem for a program where your wallet has loyalty activity or balance. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/list_my_loyalty_balances — All loyalty token balances and tier levels for the holder wallet linked to this rwk_ key. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/prepare_loyalty_token_transfer — Build B20/ERC-20 transfer calldata for the holder wallet to send loyalty tokens to any address (submit tx locally). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.005 USDC on Base)
  • POST /x402-gateway/mcp-tools/use_voucher — Loyalty rewards: Mark an active voucher as used at checkout (merchant scans code or voucher id). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: lsk_... (or Authorization: Bearer lsk_...) with the payment; without a live key you are not charged. Docs: loyalspark.online/for-agents (0.005 USDC on Base)
  • POST /x402-gateway/recipient-mcp-tools/get_recipient_profile — Loyalty rewards: Recipient agent profile bound to rwk_ API key: wallet address, key scopes, and registration metadata. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: rwk_... (or Authorization: Bearer rwk_...) with the payment; without a live key you are not charged. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • GET /x402-gateway/balance — Read B20/ERC-20 loyalty token balance for a wallet address on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • GET /x402-gateway/public-programs — Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). GET, $0.001 USDC on Base (same as GET /programs). Pay-only; no API key. Returns active public programs, not the caller's own; for the paying wallet's programs use GET /programs (pay-only; lsk_ key optional). (0.001 USDC on Base)
  • GET /x402-gateway/offers — List active P2P marketplace offers for loyalty token swaps on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Payment alone gives access; do not send an API key. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • POST /x402-gateway/recipient-api/prepare-transfer — Prepare an unsigned B20/ERC-20 loyalty token transfer transaction on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.005 USDC on Base)
  • GET /x402-gateway/recipient-api/balances — List all loyalty token balances held by a customer/recipient wallet on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • GET /x402-gateway/recipient-api/vouchers — List a customer's redeemed reward vouchers and voucher codes. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • GET /x402-gateway/recipient-api/offers — Browse open P2P marketplace offers to buy or swap loyalty tokens on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Payment alone gives access; do not send an API key. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
  • GET /x402-gateway/recipient-api/workflow/reward-status — Check whether a customer has enough tokens and eligibility to redeem a reward. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)

+103 more endpoints.

MCP tools (43)

Loyal Spark https://api.loyalspark.online/mcp

  • activate_loyalty_program — For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).
  • bazaar_discover_mcp_servers — Search Coinbase CDP's Bazaar MCP catalog (search_resources) for third-party x402-payable tools. Read-only, free. Rows are run via the Bazaar MCP server's proxy_tool_call, not here.
  • bazaar_discover_resources — Discover third-party x402-paid resources published in Coinbase CDP's Bazaar (docs, data feeds, AI inference, etc). Read-only. Filter by free-text q and/or network (e.g. 'base').
  • bazaar_pay_and_call — Pay a Loyal Spark x402 URL on api.loyalspark.online with the merchant agent's CDP MPC wallet (EIP-3009 exact scheme, Base USDC). Other hosts are refused before any signature. Requires scope 'mint' and an active CDP wallet. max_usdc default 0.25, hard limit 10.
  • bazaar_probe_x402 — Probe one x402 resource URL without paying: a single GET (https only, 5 s, 64 KB, no redirects). If it answers HTTP 402, returns a parsed summary of the x402 payment requirements (PAYMENT-REQUIRED header or accepts[]). Any other status returns error not_x402_resource with the status only: the response body is never returned. No signing. No API key needed: keyless calls are limited to 20/minute per IP; with a key the key's own limits apply.
  • check_voucher_status — Check voucher status for this merchant. Send one of code, voucher_code, or voucher_id (anyOf). If none is sent the tool returns error_code missing_identifier, an example, and next_action. Anonymous public lookup is GET /agent-api/vouchers/status.
  • confirm_mint_fee — Confirm a prepared mint on Base. Verifies the protocol-fee mint and, when recipient_tx_hash is set (or the fee receipt already contains the recipient mint), writes customer_tier_status so get_token_balance leaves 0. Same hash for both fields when EIP-5792 batched the calls. A second call with recipient_tx_hash still credits the customer after the fee is already settled.
  • create_gift_certificate — Create a gift / welcome certificate (UDS-style) with a unique random redemption code (LOYAL-XXXX-XXXX-XXXX). Customer redeems via QR or by entering the code; merchant then mints tokens on-chain. Use for welcome bonuses, promo campaigns, partnership gifts.
  • create_loyalty_program — Get factory calldata to deploy a new loyalty token on Base. Defaults to B20 (Base-native B20 asset standard, ERC-20 compatible, single tx, active immediately). Pass token_standard='erc20' for the legacy factory. For B20, MINT_ROLE is granted atomically to the merchant admin AND to the agent's CDP wallet (or explicit extra_minters) so autonomous agents can mint with no follow-up transaction.
  • create_personalized_offer — Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).
  • create_reward — Create a new reward redeemable with loyalty tokens
  • delete_report — Internal. Delete a report you submitted.
  • earn_points — Mint cashback tokens for a purchase at the program's cashback rate, optionally redeeming points first (points_to_redeem or redeem_all) to lower the payable amount. Returns a fee-first calls[] bundle (protocol fee mint, then the customer mint): submit in order (atomically via EIP-5792 if supported), then call confirm_mint_fee with obligation_id, fee_tx_hash, recipient_tx_hash. Unconfirmed fees block future mints.
  • export_customers — Export customers of one of your loyalty programs: the same wallet set and total_customers as GET /customers and get_program_analytics (voucher holders, ledger rows, completed mints), each with voucher stats, on-chain current_balance plus offchain_ledger_balance, and tier. Email-only store customers are listed in store_customers.
  • generate_program_defaults — Workflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics.
  • get_my_profile — Get authenticated agent's profile, plan limits, and current-period usage
  • get_payment_info — Free: agent Pro/Enterprise (or merchant) plan options, USDC subscription wallet, per-plan limits, annual prices, and the required-sender rule. Optional product=agent|merchant. Prefer this before paying; verify with POST /verify-agent-plan-payment action verify_payment.
  • get_platform_info — Get info about Loyal Spark protocol on Base L2
  • get_program_analytics — Get analytics for one of your loyalty programs. total_customers is the same count export_customers and GET /customers report; a program you do not own returns program_not_found.
  • get_program_workflow_status — Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)
  • get_token_balance — Get loyalty token balance and tier info for a customer (accepts 0x Base wallet address or customer email in customer_address / customer_email)
  • list_fee_obligations — List protocol-fee obligations for this API key. status=unpaid is an alias for pending. Each unpaid row includes next_action describing POST /mint/confirm.
  • list_gift_certificates — List gift certificates issued by the agent's merchant (with status and redemption info).
  • list_loyalty_programs — List loyalty programs owned by the agent's merchant
  • list_marketplace_offers — List active token trading offers on the marketplace
  • list_mints — List mint intents for this merchant. status=pending means transaction_hash is still null (confirm has not credited the recipient). status=completed means the recipient mint was recorded. GET /balance offchain_ledger_balance stays 0 until confirm.
  • list_my_reports — Internal. List reports this agent submitted (status new, reviewed, or done).
  • list_rewards — List rewards for a loyalty program by token_address. Includes redemption metrics (total vouchers issued, redeemed, and last-30-day counts) for each reward.
  • list_store_discount_codes — List discount codes for this merchant's Shopify store, plus how customers spend points (online code, register voucher, or both).
  • mark_gift_certificate_minted — After the merchant submits the on-chain mint transaction for a claimed gift certificate, call this to mark it as minted (status pending_mint -> redeemed) and store the mint tx hash.
  • mint_loyalty_tokens — Record a mint intent and get a fee-first calls[] bundle: protocol fee mint first (in the merchant's own loyalty tokens, not USDC), then the recipient mint. Submit both in order (atomically via EIP-5792 if supported), then call confirm_mint_fee with obligation_id, fee_tx_hash, recipient_tx_hash. Unconfirmed fees block future mints. recipient_address takes a 0x Base wallet or a customer email (or use recipient_email); the wallet is resolved server-side.
  • redeem_reward — Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.
  • register_loyalty_program — Register a deployed token as a loyalty program in the database. B20 tokens are registered as active; legacy ERC-20 as inactive (activate next).
  • revoke_gift_certificate — Revoke an active gift certificate (status active -> revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.
  • send_report — Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.
  • set_store_sales_channel — Set how this store's customers spend loyalty points: online (checkout code), offline (voucher at the register), or both (the shopper chooses).
  • transfer_loyalty_tokens — Build B20 token transfer calldata (ERC-20 compatible) to send loyalty tokens from your merchant wallet to any 0x address. Recipient: to (alias to_address).
  • update_program_config — Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
  • update_program_status — Update program status in database after onchain activation/pause
  • update_report_status — Internal. Set a report you submitted to reviewed or done.
  • update_reward_status — Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.
  • update_store_discount_code — Mark a Shopify discount code used, or cancel it and return the loyalty points. Same actions as the merchant discount-code journal.
  • use_voucher — Mark a voucher as used at the merchant. Send one of voucher_code (alias code) or voucher_id (anyOf). If neither is sent the tool returns error_code missing_identifier and an example. A voucher used before returns error_code voucher_already_used (do not retry).

First seen · last seen · last active