{"uid":"cap_7Fc0Z9uFdENBCZA1k4I16","slug":"api-loyalspark-online-8fd29b72","name":"Loyal Spark API — Balance","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. Free plan mints up to 1,000 tokens per month; every call is scoped by row-level security to the wallet behind the API key. 16 skill guides at loyalspark.online/.well-known/skills/index.md.","url":"https://api.loyalspark.online/x402-gateway/balance","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"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.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vUSfcW6yI7WBv-3t0NXBh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the current balance for a loyalty account via the Loyal Spark x402-gated API","exampleAgentPrompt":"Can you check the current balance on my Loyal Spark loyalty account?","exampleUseCases":null,"resultDescription":"Returns the current balance for the loyalty account, likely including points or currency balance details associated with the authenticated account.","failureModes":["401/402 Unauthorized if payment or auth headers are missing","404 if account not found","500 internal server error if Loyal Spark backend is unavailable","Empty or zero balance returned for new accounts","Rate limiting errors if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need to retrieve the current balance for a loyalty account on the Loyal Spark platform. Prefer this over recipient-api/balance or recipient-api/balances if you are acting as the primary account holder rather than a recipient, or if you need a single unified balance read via the x402-gated gateway.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:46.793Z","isFirstParty":false}