Token Launchers

Not every game launches with its own token. When a game is registered without a GameCoin, anyone can launch one for it - becoming the "token launcher" and gaining first-buyer advantages.

What is a GameCoin?

A GameCoin is a Solana token created specifically for a game on Open Game Protocol. It powers:

• Daily leaderboard rewards - Top players earn GameCoin based on rank

• Score multipliers - Players buy multipliers with GameCoin to boost scores

• Trading - GameCoins are tradeable on Meteora/Jupiter

• Self-sustaining economy - Rewards grow from multiplier purchases, emissions, and fees

Who Can Launch a GameCoin?

Game Developer

When registering a game, developers can choose to launch a GameCoin immediately by setting launchGameCoin: true. This gives them control over the token from day one.

External Launcher (You!)

If a game doesn't have a GameCoin yet, anyone can launch one. This creates an opportunity for:

• Investors who believe in a game's potential

• Community members who want to bootstrap rewards

• Speculators looking for first-mover advantage

Benefits of Being the Launcher

When you launch a GameCoin for a game:

1. First Buyer Rights - You can include an initial buy amount at launch, getting tokens at the lowest possible price on the bonding curve

2. Early Position - You're in before any trading activity

3. Community Credit - You helped bootstrap the game's economy

How to Find Games Without Tokens

Look for games on opengame.gg that show "Launch GameCoin" instead of a token price. These games are waiting for someone to launch their token.

Via API, you can query games and check if gameCoin is null:

const response = await fetch(
  'https://api.opengameprotocol.com/games/id/{gameId}'
);
const game = await response.json();

if (!game.gameCoin) {
  console.log('This game has no GameCoin - you can launch one!');
}

Launching a GameCoin

Via the Website

1. Navigate to a game without a GameCoin

2. Click "Launch GameCoin"

3. Optionally enter an initial buy amount (in SOL)

4. Confirm the transaction

5. Wait for the launch to complete (~30 seconds)

Via API

// Requires user authentication
const response = await fetch(
  'https://api.opengameprotocol.com/token-launcher/launch',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': '...' // User auth required
    },
    body: JSON.stringify({
      gameId: 'game-uuid',
      buyAmount: '100000000' // Optional: lamports to spend on initial buy
    })
  }
);

const { jobId } = await response.json();

// Poll for status
const status = await fetch(
  `https://api.opengameprotocol.com/token-launcher/launch/${jobId}`
);

Token Economics

Total Supply

Every GameCoin has a fixed total supply of 1,000,000,000 tokens (1 billion).

Supply Allocation

The supply is divided into three portions:

Allocation	Percentage	Description
Bonding Curve	30%	Available for trading on the bonding curve
Liquidity Pool	20%	Reserved for graduation to Meteora DEX
Launch Leftovers	50%	Split between rewards pool and optional airdrop

Launch Leftovers Split

The 50% "Launch Leftovers" allocation is configurable at launch time:

• Airdrop Allocation: 0-50% of leftovers (configurable)

  • If 0%: All leftovers go to the rewards pool

  • If 50%: Half of leftovers go to airdrop claimants, half to rewards

• Distribution Vault: Remainder goes to the player rewards pool

For example, if airdrop allocation is set to 40%:

• 20% of total supply (40% of 50%) → Airdrop claims

• 30% of total supply (60% of 50%) → Rewards pool

Bonding Curve

GameCoins use a bonding curve for price discovery:

• Price starts low and increases as more tokens are bought

• No liquidity pool needed initially

• Automatic market making

• 2% trading fee on swaps

Graduation

When a GameCoin reaches ~$125,000 USD market cap, it "graduates" to a full AMM pool on Meteora. The reserved 20% liquidity allocation is used to seed the pool, providing improved liquidity for trading.

Reward Pool Sources

The daily reward pool grows from multiple sources:

1. Multiplier Purchases - 100% of GameCoin spent on score multipliers goes to player rewards

2. Daily Emissions - A percentage of the distribution vault emits daily

3. Trading Fees - A portion of trading fees flows to the reward pool

Airdrop Claims

If the game developer specified an airdropTokenAddress when registering, holders of that token can claim a portion of the GameCoin. This helps existing communities transition to the new token.

Check claim eligibility:

const response = await fetch(
  `https://api.opengameprotocol.com/token-launcher/exercise-claim/${gtokenAddress}/status/${walletAddress}`
);
const { eligible, claimableAmount } = await response.json();

Risks and Considerations

• No Guarantees - A game having a token doesn't guarantee success or returns

• Market Risk - Token prices can go down as well as up

• Game Dependency - Token value is tied to game engagement

• Smart Contract Risk - As with all DeFi, there are technical risks

API Reference

Launch Token

POST /token-launcher/launch
Body: { gameId: string, buyAmount?: string }
Returns: { jobId: string }

Check Launch Status

GET /token-launcher/launch/:jobId
Returns: { status: string, progress: number, message: string, gtokenAddress?: string }

Get Snapshot (for airdrops)

GET /token-launcher/snapshot/:tokenMint
Returns: { merkleRoot: string, totalHolders: number, ... }

Get User Proof (for claiming)

GET /token-launcher/snapshot/:tokenMint/proof/:userAddress
Returns: { proof: string[], amount: string, ... }

Check Claim Status

GET /token-launcher/exercise-claim/:gtokenAddress/status/:wallet
Returns: { eligible: boolean, claimableAmount: string, claimed: boolean }