Create a custom event for your loyalty program. Events are infinitely flexible - any string can be an event type. Once created, the backend handles: fire event → check auth → reward from balance.

See also: loyalteez://docs/guides/custom-events

Create multiple events at once. Perfect for setting up entire programs. Returns all created events plus platform-specific implementation code.

See also: loyalteez://docs/guides/custom-events

Fire any event. Works for ANY event type - predefined or custom. The backend handles: check auth (brandId) → check eligibility → reward from balance.

See also: loyalteez://docs/api/rest-api

Get all active event configurations for a brand, including custom events, reward amounts, and detection methods. Use this to understand what events are available and how much LTZ each event rewards.

See also: loyalteez://docs/api/rest-api

Submit multiple events in a single request. Use this for batch processing, importing historical data, or high-volume integrations. More efficient than calling track_event multiple times.

See also: loyalteez://docs/api/rest-api

Manually reward users (mod/admin triggered). Wrapper around track_event with admin context. Use this when admins want to manually reward users for special contributions.

See also: loyalteez://docs/api/rest-api

Design a complete loyalty program from context. AI analyzes your app/community and generates optimal event structure, tiers, streaks, and implementation code.

Uses documentation context to generate platform-specific implementations and best practices.

See also:

• loyalteez://docs/architecture

• loyalteez://docs/integrations/discord

• loyalteez://docs/integrations/telegram

• loyalteez://docs/guides/custom-events

Convert any platform identity to a Loyalteez wallet. Creates wallet if needed. Uses deterministic email pattern: {platform}_{userId}@loyalteez.app.

See also: loyalteez://docs/architecture

Process a streak check-in with automatic multipliers and milestones. Tracks consecutive daily activity and applies bonus multipliers.

See also: loyalteez://docs/shared-services/streak-service

Get ranked leaderboards by any metric. Supports multiple time periods and platform filtering.

See also: loyalteez://docs/shared-services/leaderboard-service

Get a user's current streak status including streak length, multiplier, next milestone, and whether they've checked in today.

See also: loyalteez://docs/shared-services/streak-service

Claim a milestone bonus (7, 30, 100, 365 days) for a user's streak. Returns the bonus LTZ amount awarded.

See also: loyalteez://docs/shared-services/streak-service

Track voice time, messages, reactions with daily caps. Returns reward earned, daily progress, and cap status.

See also: loyalteez://docs/shared-services/activity-service

Calculate final reward with role multipliers & bonuses. Returns breakdown of base reward, multipliers, and final amount.

Supports Discord role bonuses (multipliers 1.0-5.0x and flat bonuses 0-1000 LTZ). Multiple roles combine based on stacking mode (multiplicative, additive, highest_only).

See also: loyalteez://docs/shared-services/tier-service

Update user statistics after rewarding them. This keeps leaderboard data current. Call after every reward distribution.

See also: loyalteez://docs/shared-services/leaderboard-service

Get a user's current LTZ balance and recent transaction history. Use this to display balance in your app or verify rewards were distributed.

Implementation Note: LTZ balances are stored on-chain. If the API endpoint is unavailable:

1. Get the user's wallet address via loyalteez_resolve_user or SDK getUserWallet()

2. Query the LTZ token contract (0x5242b6DB88A72752ac5a54cFe6A7DB8244d743c9) using balanceOf(address) on Soneium Mainnet (Chain ID: 1868)

See also: loyalteez://docs/api/rest-api, loyalteez://contracts/ltz-token

Check if a user is eligible to receive a reward for a specific event. Returns eligibility status, cooldown info, and claim history. Use this BEFORE tracking an event to validate the user can receive the reward.

Implementation Note: Eligibility checking requires event configuration (maxClaims, cooldown, reward) and user claim history. If the endpoint is unavailable, eligibility can be determined by:

1. Calling loyalteez_get_event_config to get event settings

2. Checking user's claim count against maxClaims

3. Verifying cooldown period has elapsed

See also: loyalteez://docs/api/rest-api

Get comprehensive stats for a single user including balance, lifetime earnings, streak, activity, and rank.

Implementation Note: User stats aggregate data from multiple services. If the aggregation endpoint is unavailable, stats can be obtained by calling:

• loyalteez_get_streak_status for streak data

• loyalteez_get_leaderboard for rank and lifetime earnings

• loyalteez_get_user_balance for balance

• Platform-specific APIs for activity (messages, voice, reactions)

See also: loyalteez://docs/shared-services/leaderboard-service

Execute a gasless blockchain transaction. Users can claim perks, transfer LTZ, or interact with Loyalteez contracts without needing ETH for gas. Requires Privy authentication.

See also: loyalteez://docs/api/gas-relayer

Create time-limited reward drops (reaction drops, claim buttons). Returns drop ID, claim URL, and embed data for posting.

See also: loyalteez://docs/shared-services/drops-service

Process a drop claim from a user. Returns success status, reward amount, position, and remaining claims.

See also: loyalteez://docs/shared-services/drops-service

Handle events from Mee6, Arcane, Tatsu, etc. Parses bot messages and converts to Loyalteez events. Use this to integrate with existing Discord leveling bots.

See also: loyalteez://docs/integrations/third-party

Get all available perks (NFT rewards) that users can claim with their LTZ balance. Returns perk details, pricing, and availability.

See also: loyalteez://docs/shared-services/perks-service

Check if user can claim a specific perk. Returns eligibility status, balance check, cost, and missing amount.

See also: loyalteez://docs/shared-services/perks-service

Redeem a perk for a user. Creates a redemption record and returns confirmation code. Note: You must separately deduct LTZ from the user's balance.

See also: loyalteez://docs/shared-services/perks-service

Get all achievements for a user, showing progress toward each and which are unlocked.

See also: loyalteez://docs/shared-services/achievement-service

Update user progress toward an achievement. When progress reaches the threshold, the achievement automatically unlocks. Returns newly unlocked achievements.

See also: loyalteez://docs/shared-services/achievement-service

Check the health status of Loyalteez APIs. Verifies that the Event Handler, database, blockchain, and Privy services are operational. Useful for diagnostics and verifying API availability before making calls.

See also: loyalteez://docs/api/rest-api

Validate a webhook signature to ensure the request is from Loyalteez. Use this to verify webhook authenticity before processing events.

Webhook signatures use HMAC-SHA256. Always verify signatures to prevent unauthorized requests.

See also: loyalteez://docs/guides/webhooks

Generate complete webhook receiver code for your framework. Returns ready-to-use code with signature verification, error handling, and event processing.

Supports: Node.js/Express, Next.js API routes, Python/Flask, Ruby/Rails, PHP.

See also: loyalteez://docs/guides/webhooks