{"uid":"cap_YpdhEIAreIBJqooPnz27i","slug":"loyal-spark-get-token-balance-504eb942","name":"Loyal Spark Get Token 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/mcp-tools/get_token_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":{"request":{"id":1,"method":"tools/call","params":{"name":"get_platform_info","arguments":{}},"jsonrpc":"2.0"},"response":{"id":1,"result":{"content":[{"text":"{\"name\":\"Loyal Spark\",\"chain\":\"Base L2\",\"chain_id\":8453,\"token_standard\":\"ERC-20\",\"features\":[\"loyalty_programs\",\"rewards\",\"marketplace\",\"tiers\",\"referrals\",\"vouchers\",\"analytics\"],\"api_docs\":\"https://loyalspark.online/api-docs\"}","type":"text"}]},"jsonrpc":"2.0"}},"exampleRequest":{"id":1,"method":"tools/call","params":{"name":"get_platform_info","arguments":{}},"jsonrpc":"2.0"},"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_Qnn8QeuZa6nn-Ao-jpE3j","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 ERC-20 loyalty token balance for a given wallet address on the Base L2 blockchain","exampleAgentPrompt":"Check my Loyal Spark loyalty token balance on Base for wallet address 0xAbc123...def456 — I want to know how many reward tokens I currently hold.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the ERC-20 token balance for the specified wallet address on the Base L2 network, expressed as a numeric token amount (likely including raw and formatted values).","failureModes":["Invalid or malformed wallet address returns an error response","Contract address not found on Base L2 returns empty or error","Network congestion or RPC timeout causes delayed or failed response","Wallet with zero balance returns 0 rather than an error","Payment of $0.01 USDC via x402 fails due to insufficient funds"],"whenToPreferThis":"Use this endpoint when you need to programmatically query a user's onchain ERC-20 loyalty token balance on Base L2, especially within the Loyal Spark ecosystem. Prefer this over general blockchain explorers when you need a clean, structured JSON response ready for agent workflows or loyalty program automation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:40:55.894Z","isFirstParty":false}