Score Multipliers

Score multipliers allow players to boost their effective points on the daily leaderboard by purchasing a multiplier with GameCoins (or SOL). This creates an additional monetization layer and drives demand for game tokens.

How Multipliers Work

• Players can purchase multipliers (2x, 3x, 5x, etc.) for a specific game

• The multiplier applies to today's points only - it resets daily

• Higher multipliers cost more, following a bonding curve

• Purchases are made using the game's GameCoin (or SOL, which is swapped automatically)

• All multiplier purchases go into the player reward pool - they're redistributed to players

For Game Developers

No integration work required! Multipliers work automatically with SDK integration. Players purchase multipliers through the OGP interface, and their points are automatically boosted.

The SDK handles:

• Displaying multiplier purchase options

• Processing payments (GameCoin or SOL)

• Applying multipliers to point calculations

• Showing boosted leaderboard positions

For Players

Players can:

1. View their current multiplier status

2. See the cost to upgrade to higher multipliers

3. Calculate cost to reach a specific leaderboard position

4. Purchase multipliers using GameCoins or SOL

Pricing Model

Multipliers use a quadratic bonding curve that considers:

1. Per-level cost: Each multiplier level costs baseCost * level²

2. Global demand: As more players buy multipliers, prices increase

3. Daily spend cap: A soft cap that triggers exponential pricing when exceeded

This creates fair pricing where:

• Early multipliers are affordable

• High multipliers require significant investment

• Prices adjust based on game activity

API Reference

Get Multiplier Cost

Calculate the cost to purchase a specific multiplier level.

GET /multiplier/cost

Query Parameters:

Param	Type	Description
gameId	string	Game UUID
multiplier	number	Desired multiplier level (e.g., 2, 3, 5)

Response:

{
  "atomicAmountRequired": "1000000000",
  "solAmountRequired": "50000000",
  "gameCoin": {
    "mint": "...",
    "symbol": "GAME",
    "decimals": 9
  },
  "currentMultiplier": 1,
  "currentAtomicSpent": "0"
}

Get Current Multiplier

Check a user's current multiplier status for today.

GET /multiplier/current

Query Parameters:

Param	Type	Description
gameId	string	Game UUID

Response:

{
  "currentMultiplier": 2.0,
  "totalSpent": "500000000"
}

Calculate Cost for Leaderboard Position

Find out what multiplier (and cost) is needed to reach a specific position.

GET /multiplier/cost-for-placement

Query Parameters:

Param	Type	Description
gameId	string	Game UUID
placement	number	Desired leaderboard position (1 = first place)

Response:

{
  "atomicAmountRequired": "2500000000",
  "solAmountRequired": "125000000",
  "multiplierNeeded": 3.5,
  "gameCoin": { ... }
}

Purchase Multiplier

Execute a multiplier purchase.

POST /multiplier/purchase

Body:

{
  "gameId": "uuid",
  "multiplier": 3,
  "useSol": true,
  "approvedAmount": "150000000"
}

Notes:

• Requires user authentication

• useSol: true will swap SOL to GameCoin automatically

• approvedAmount must cover the cost (with buffer for SOL swaps)

How It Affects Leaderboards

Leaderboards show effective points = base points * multiplier

Example:

• Player A: 1000 points, 1x multiplier = 1000 effective points

• Player B: 800 points, 2x multiplier = 1600 effective points

• Player B ranks higher despite fewer base points

Where Multiplier Revenue Goes

All GameCoin spent on multipliers goes into the player reward pool:

• 100% of purchases are added to the daily distribution pool

• This increases rewards for all players in that game

• Creates a positive feedback loop: multipliers → more rewards → more players

Technical Details

• Multipliers are stored on the PointsDaily record for each user/game/date

• The activeMultiplier field tracks the current multiplier level

• multiplierSpendAtomic tracks total spent (for incremental pricing)

• Purchases are recorded on-chain via recordDailyPurchase transaction

• Daily reset happens at UTC midnight