{"uid":"cap_Mr65x74ElGfnlLFRrNVMy","slug":"loyal-spark-list-my-loyalty-balances-32002455","name":"Loyal Spark - List My Loyalty Balances","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/list_my_loyalty_balances","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_sXaygAKljK621t5w0h2JF","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 current ERC-20 loyalty token balances held by the authenticated user across all programs on the Loyal Spark onchain protocol (Base L2).","exampleAgentPrompt":"Show me all my current loyalty token balances across every program on Loyal Spark — I want to see what I've earned and what I can redeem.","exampleUseCases":[{"title":"Audit loyalty rewards before redeeming","prompt":"Pull up all my Loyal Spark token balances so I can figure out which programs I have enough rewards in to actually redeem something useful."},{"title":"Find tradeable loyalty tokens","prompt":"Check all my onchain loyalty token holdings on Loyal Spark — I want to see which ones I could trade peer-to-peer with someone else."},{"title":"Review earned rewards across merchants","prompt":"Show me a full breakdown of every loyalty program I've earned tokens in on Loyal Spark so I can see which merchants have rewarded me the most."}],"resultDescription":"A JSON response listing the caller's loyalty token balances across all enrolled Loyal Spark programs, including token amounts, ERC-20 token identifiers, and program names on Base L2.","failureModes":["Unauthenticated or missing wallet identity returns 401/403","No loyalty balances found returns empty list or 404","Payment of $0.01 USDC not provided returns x402 payment required error","Onchain RPC node unavailable causes timeout or 503","Invalid wallet address format returns 400 bad request"],"whenToPreferThis":"Use this endpoint when an AI agent or user needs to audit their current loyalty token holdings across all Loyal Spark programs on Base L2. Prefer this over general blockchain balance queries when the context is specifically about loyalty rewards earned through Loyal Spark merchants or campaigns, and when the goal is to decide what to redeem or trade P2P.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:49:30.387Z","isFirstParty":false}