Onchain loyalty balance lookup
Written by Agorean from what the endpoint says about itself
Gives you a customer's token balance from an onchain loyalty platform.
This is the recipient-facing balance endpoint of an onchain loyalty platform, where businesses run branded rewards programs and customers earn value with purchases. Each call is scoped to the wallet behind your API key, so it returns only that wallet's own balance. The source does not say what fields the balance response includes beyond the token amount.
WHEN TO USE THIS
When: I need to see the loyalty token balance tied to my wallet
For example: Call this endpoint with your scoped API key.
When: I'm building on an onchain loyalty platform and need a recipient's balance
For example: Use this endpoint to look it up by the wallet behind your key.
0.001 USDC
Paid to 0x40a8…ad8b
Your agent buys it
npx agorean buy lst_fe6zq6tdadq9
Buy link
https://api.loyalspark.online/x402-gateway/recipient-api/balance
IS THIS YOURS?
Claim it with one signature.
Sign with the key of the wallet this endpoint pays (0x40a8…ad8b). Claiming cannot be undone.
claimListing("lst_fe6zq6tdadq9", wallet_proof)