Skip to content

GamifyHost API Documentation

Turn user actions into points. Let users spend points on games. Reward them with real prizes.

1. Award Points

Your backend calls POST /v1/points/award whenever a user performs a rewardable action (signup, purchase, referral, etc.).

2. Users Play Games

Users spend points to play Neon Wheel, Cosmic Slots, or Enigma Boxes directly inside your app via the embeddable widget or Flutter SDK.

3. Win Real Rewards

Game outcomes are determined server-side. Winners receive cashback, XP, bonus points, or custom rewards dispatched via webhooks.

4. Track & Compete

Leaderboards rank players by score. All plays and point transactions are recorded in an auditable ledger.

Game Play API (Client-Side)

Authenticated with X-API-Key (public key). Powers the widget and mobile SDKs: listing games, playing games, leaderboards, user balance.

Game API (Server-Side)

Authenticated with X-API-Secret (secret key). Server-to-server integration for awarding points, querying balances, and reading transaction history.