Token Launchers

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

What is a Playcoin?

A Playcoin is a Solana token created specifically for a game on Play Fun. Each game can have one active playcoin at a time. It powers:

• Daily leaderboard rewards - Top players earn playcoins based on rank via a power-law distribution

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

• Trading - Playcoins are tradeable on Meteora/Jupiter

• Emission schedule - Rewards are distributed over a fixed period (7 or 30 days)

Who Can Launch a Playcoin?

Game Developer

When registering a game, developers can choose to launch a playcoin immediately by setting launchGameCoin: true. This gives them control over the token from day one. After a playcoin's emission ends, the creator gets a 48-hour grace period to launch the next one.

External Launcher (You!)

If a game doesn't have a playcoin yet (or the grace period has passed), 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 playcoin 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

Emission Schedule

Every playcoin has an emission schedule that determines how long rewards are distributed:

Duration	Description
7 days	Higher daily rewards, great for generating buzz and short-term engagement
30 days	Sustained daily rewards, better for building consistent player engagement

During the emission period, a portion of the distribution vault is emitted daily to the reward pool. On the last emission day, any remaining balance is distributed.

After emission ends, a new playcoin can be launched for the game, starting a fresh cycle.

How to Find Games Without Tokens

Look for games on play.fun that show "Launch Playcoin" 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.play.fun/games/id/{gameId}');
const game = await response.json();

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

Launching a Playcoin

Via the Website

1. Navigate to a game without a playcoin

2. Click "Launch Playcoin"

3. Choose your emission period (7 or 30 days)

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

5. Confirm the transaction

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

Via API

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

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

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

Token Economics

Total Supply

Every playcoin 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

Playcoins 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 playcoin reaches ~$1,000,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 playcoins spent on score multipliers goes to player rewards

2. Daily Emissions - A percentage of the distribution vault emits daily based on the emission schedule

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 playcoin. This helps existing communities transition to the new token.

Check claim eligibility:

const response = await fetch(
  `https://api.play.fun/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

For full endpoint documentation with request/response schemas, error codes, and code examples, see:

Token Launcher API Endpoints