{"uid":"cap_G5T2NQWVx0aBKNWft3MH1","slug":"loyal-spark-earn-points-d29ebdf5","name":"Loyal Spark - Earn Points","description":"Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.","url":"https://api.loyalspark.online/x402-gateway/mcp-tools/earn_points","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","toolName","inputSchema"],"properties":{"type":{"type":"string","const":"mcp"},"example":{"type":"object"},"toolName":{"type":"string"},"transport":{"enum":["streamable-http","sse"],"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_oRfJIK9FC0xrQUiqiDz_t","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":"Awards onchain ERC-20 loyalty points to a user wallet on Base L2 as part of the Loyal Spark loyalty protocol.","exampleAgentPrompt":"Award 50 loyalty points to wallet 0xAbC...123 on Loyal Spark for completing a purchase in the 'CoffeeBrew' rewards program.","exampleUseCases":[{"title":"Reward customer after purchase","prompt":"Give 100 loyalty points to wallet 0xDef...456 in the 'StyleHub' rewards program because they just completed a $75 purchase on our store."},{"title":"Credit points for referral action","prompt":"Award 200 loyalty tokens to wallet 0x789...ABC on Loyal Spark for successfully referring a new member to our 'FitLife' loyalty program."},{"title":"Automate daily check-in rewards","prompt":"Send 10 loyalty points to wallet 0x321...FED in the 'GamersClub' program every time a user logs a daily check-in activity on our platform."}],"resultDescription":"Returns a JSON confirmation including the transaction hash on Base L2, the number of points credited, the recipient wallet address, and the updated points balance for the user in the specified loyalty program.","failureModes":["Invalid or missing wallet address returns an error response","Insufficient USDC payment ($0.01) causes x402 payment failure","Unknown loyalty program ID results in a not-found error","Blockchain congestion or Base L2 outage may delay confirmation","Duplicate activity reference may trigger idempotency rejection","Malformed request body returns a validation error"],"whenToPreferThis":"Use this endpoint when you need to programmatically award onchain ERC-20 loyalty points to a specific wallet address on Base L2 as part of the Loyal Spark protocol. Prefer this over traditional loyalty APIs when the program requires verifiable onchain token records, P2P tradability of rewards, or AI agent automation via MCP.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:33:23.836Z","isFirstParty":false}