Back to Browse
Loyal Spark Recipient API - Accept Offer
x402
Loyal Spark Recipient API - Accept Offer is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).
Accepts a peer-to-peer trade offer for loyalty reward tokens on the Loyal Spark onchain protocol (Base L2)
Price / call$0.01
Success—
StatusUnknown
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 object with an 'ok' boolean indicating success and a 'resource' field confirming the accepted endpoint path (e.g. {ok: true, resource: 'recipient-api/accept-offer'}), signaling the offer has been accepted onchain.
Example use cases
Claim pending loyalty token swap
“I just got a notification that someone sent me a loyalty token offer on Loyal Spark — can you accept it on my behalf so the tokens get transferred to my wallet right away?”
Finalize peer-to-peer reward deal
“My friend sent me some of their coffee shop loyalty tokens through Loyal Spark and I want to finalize the trade — go ahead and accept the offer so the ERC-20 tokens land in my account on Base.”
Confirm incoming token exchange offer
“There's a pending reward token exchange waiting for me on the Loyal Spark protocol — please accept it and confirm the deal is done onchain so I can start using those loyalty points.”
Technical details
Endpoint
POSThttps://api.loyalspark.online/x402-gateway/recipient-api/accept-offerWhen to prefer
Use this endpoint when an AI agent or user needs to accept an existing P2P loyalty token trade offer on the Loyal Spark protocol. This is specifically for the recipient side of an offer — not for creating offers, earning points through purchases, or redeeming tokens directly with a merchant. Choose this when the user has received a trade offer and wants to finalize the exchange of ERC-20 loyalty tokens on Base L2.
Side effects
- Offer already accepted or expired — returns error indicating invalid offer state
- Missing required body fields (type, method, bodyType, body) — returns 400 validation error
- Invalid method value (only POST/PUT/PATCH accepted) — schema validation failure
- Payment not included or insufficient USDC — x402 payment required error
- Offer ID not found or not addressed to caller — authorization or not-found error
- Network or Base L2 RPC failure — server-side 5xx error
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object | |
| inputSchema | object |
Output
Schema · Response
{
"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."
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"