Loyal Spark - Loyalty Rewards That Grow

Showing 25 of 39 from the live probe.

• Get Platform Info

  Get info about Loyal Spark protocol on Base L2

• Get My Profile

  Get authenticated agent's profile

• 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 Program Workflow Status

  Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)

• List Loyalty Programs

  List loyalty programs owned by the agent's merchant

• Create Loyalty Program

  Get factory calldata to deploy a new loyalty token on Base. Defaults to B20 (Base native ERC-20 superset, 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.

• 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).

• Activate Loyalty Program

  For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).

• Update Program Status

  Update program status in database after onchain activation/pause

• Update Program Config

  Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)

• 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.

• Create Reward

  Create a new reward redeemable with loyalty tokens

• Mint Loyalty Tokens

  Record mint intent and get a fee-first `calls[]` bundle: protocol fee mint FIRST, then the recipient mint. The protocol fee is charged in the merchant's own loyalty tokens (not USDC). Submit both calls in order (atomically via EIP-5792 send_calls if your wallet supports it), then call confirm_mint_fee (or POST /agent-api/mint/confirm) with the fee tx hash. Unconfirmed fee obligations block future mints.

• Transfer Loyalty Tokens

  Get calldata to transfer loyalty tokens between wallets

• Earn Points

  Calculate and mint loyalty tokens based on purchase amount and program's cashback rate. Returns a fee-first `calls[]` bundle (protocol fee mint first, then the customer mint) — submit in order, atomically via EIP-5792 if supported, then call confirm_mint_fee (or POST /agent-api/mint/confirm). Unconfirmed fee obligations block future mints.

• Confirm Mint Fee

  Confirm that the protocol fee transaction for a previous mint/earn was broadcast on Base. Verifies the fee mint on-chain and clears the obligation. Unconfirmed fee obligations block future mints.

• Get Token Balance

  Get loyalty token balance and tier info for a customer

• Get Program Analytics

  Get analytics for your loyalty programs

• List Marketplace Offers

  List active token trading offers on the marketplace

• Redeem Reward

  Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.

• Use Voucher

  Mark a voucher as used (redeemed by customer at merchant). Merchant-only operation.

• Check Voucher Status

  Check voucher status by code or ID. Public endpoint — no API key or authentication required.

• Get Platform Stats

  Get global platform statistics across all merchants. Admin-only: requires agent owned by an admin wallet.

• Cancel Stale Offers

  Cancel marketplace offers that have been active for more than N days with no completions. Admin-only action tool.

• Create Personalized Offer

  Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).