{"uid":"cap_7GkCVhZspC3jwURSY645Z","slug":"loyal-spark-get-my-loyalty-balance-a7c64a50","name":"Loyal Spark - Get My Loyalty Balance","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/recipient-mcp-tools/get_my_loyalty_balance","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_vB2-FuLTumBvrvxzwRZCd","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":"Retrieves the caller's current onchain ERC-20 loyalty token balance on the Base L2 network","exampleAgentPrompt":"Can you check my current Loyal Spark loyalty token balance on Base L2 for my wallet so I know how many reward tokens I have available to redeem?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the caller's current loyalty token balance, likely including the ERC-20 token amount, token symbol, and associated loyalty program details on the Base L2 network.","failureModes":["Wallet address not found or not enrolled in any loyalty program — returns empty or zero balance","Invalid or missing authentication credentials — returns 401 unauthorized","Payment of $0.01 USDC not provided via x402 protocol — returns 402 payment required","Base L2 network congestion or RPC issues causing delayed or failed lookups","Loyalty program contract address not recognized — returns error or null balance"],"whenToPreferThis":"Use this endpoint when an AI agent or user needs to check their own loyalty token balance on the Loyal Spark protocol on Base L2. Prefer this over generic blockchain balance lookups because it is specifically scoped to Loyal Spark's loyalty reward tokens and returns program-context-aware data rather than raw ERC-20 transfer logs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:24.003Z","isFirstParty":false}