{"uid":"cap_6YhyXKK5tW42urp1Vb3UF","slug":"loyal-spark-earn-endpoint-4c99a2a8","name":"Loyal Spark Earn Endpoint","description":"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. On the paid retry send the payment together with header x-api-key: lsk_... or Authorization: Bearer lsk_.... A payment without a live key is not charged. Read key, no browser: POST https://api.loyalspark.online/x402-gateway/register-agent. HTTP 402 is $0.01 USDC on Base. Pay it and do not send an API key. You receive lsk_ once, scope read only: list your programs, rewards, balances, and analytics. That key cannot mint, deploy a program, create rewards, or trade. A new wallet gets a 45-day Pro trial (5 agents, 10,000 calls/month), then Free (1 agent, 200 calls/month, 1,000 tokens minted/month, 1.25% mint fee) unless that wallet pays. The $0.01 is the call price, not a subscription. No free seat returns 403 before any charge. Write scopes (mint, create_program, manage_rewards, trade) use the same plan: dashboard https://loyalspark.online/merchant → AI Agents, or free SIWE — POST https://api.loyalspark.online/siwe-nonce, sign Chain ID 8453 with the exact phrase 'Register Loyal Spark merchant agent', then POST {message, signature, name, scopes} to https://api.loyalspark.online/agent-register-siwe. Look first with no key: GET https://api.loyalspark.online/x402-gateway/public-programs ($0.001, active programs, not your own list). Guide: https://loyalspark.online/.well-known/skills/00-getting-started.md The call is scoped to the wallet behind that key. 16 skill guides at loyalspark.online/.well-known/skills/index.md.","url":"https://api.loyalspark.online/x402-gateway/earn?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_H3wiubzm3oH4ZlAk2tGKR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Credits loyalty reward tokens to a user or account on the Loyal Spark onchain loyalty protocol running on Base L2","exampleAgentPrompt":"Record an earn event on Loyal Spark for customer wallet 0xABC...123 who just made a qualifying purchase — post it as a JSON body so their loyalty tokens get credited onchain.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a boolean 'ok' field indicating success and a 'resource' field set to 'earn', confirming that the earn event was recorded on the Loyal Spark protocol.","failureModes":["Invalid or missing required body fields returns a validation error","Unsupported HTTP method in 'method' field returns an enum validation error","Payment not included or insufficient USDC results in 402 Payment Required","Malformed JSON body returns a parse error","Unauthorized or invalid credentials may return 401 or 403","Network or blockchain congestion may cause delays or timeouts"],"whenToPreferThis":"Use this endpoint when you need to programmatically credit or accrue loyalty reward tokens for a user on the Loyal Spark onchain protocol hosted on Base L2. Prefer this over generic webhook triggers when you specifically need the result to be recorded as an immutable earn event in the Loyal Spark ecosystem, with AI agent and MCP automation support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:06:48.934Z","isFirstParty":false,"canonicalSlug":"loyal-spark-earn-endpoint-4c99a2a8"}