Track daily reward availability for an in-game HUD button

If you want to show an in-game state such as Free Reward Available for Aghanim daily rewards, the current recommended approach is to use the item.add webhook to detect when a player has already claimed that day's reward.

Recommended approach

• Listen for item.add webhooks with the daily reward claim trigger.
• When a player claims a daily reward, treat that as the signal that the reward is no longer available for that player that day.
• Update your in-game UI accordingly, for example by clearing a badge, tick, or notification state after claim.

Daily reward reset timing

Daily rewards reset at midnight UTC each day.

If you are determining availability on the game side, make sure your logic uses UTC rather than local device time where possible. Relying only on the device clock can cause desyncs.

Simpler UX option

If you do not need exact claim-state syncing, a simpler implementation is to show a once-per-day notification (such as a red dot) on the Hub link-out button and clear it after the player clicks through to the Hub.

This is easier to implement and still gives players a strong reminder to check the Hub daily.

Current limitation

At the time of writing, there is no documented webhook field that directly tells the game whether a daily reward is currently available again after reset. A dedicated reward-status API has been discussed but should not be assumed to exist unless confirmed separately.

Testing daily rewards

For testing, you can reset daily rewards for a specific player in the Dashboard under the Player Profile → Daily Rewards section.

Related documentation

• item.add webhook documentation covers daily reward claim events.
• Aghanim documentation also describes using in-game buttons to drive players to Hub reward flows.