PULSE5 DOCUMENTATION

HOW IT WORKS

Everything you need to know about PULSE5 — the 5-minute memecoin prediction market on Solana. Powered by bags.fm and PumpFun.

OVERVIEW

PULSE5 is a binary prediction market built on Solana. You predict whether a memecoin's price will go UP ▲ or DOWN ▼ over a 5-minute window. If your prediction is correct, you win a proportional share of the total bet pool.

Markets are created automatically every 30 seconds from live token launches on bags.fm and PumpFun. You can also manually create a market for any token by searching its contract address.

5-Min Windows
Real SOL Prizes
No KYC
Live Price Data
Any Token
Auto-Resolution
BAGS HACKATHON 2025
PULSE5 was built for the bags.fm Hackathon 2025. Token price data is sourced from the bags.fm API with DexScreener as a fallback oracle.

GETTING STARTED

You can be placing your first prediction in under 60 seconds. Here's how:

1
Connect your Solana wallet

Click "Connect Wallet" in the top navigation. PULSE5 supports Phantom, Solflare, OKX Wallet, and any Solana wallet via Privy. You can also sign in with email to create an embedded wallet.

2
Fund your wallet with SOL

Make sure you have SOL available. The minimum bet is 0.01 SOL. You can deposit SOL by scanning the QR code shown in the wallet panel after connecting.

3
Find an active market

Go to the Markets page (/app). Browse active prediction markets or use the token search bar to find a specific token by its Solana contract address.

4
Place your prediction

Click a market card to open it. Choose UP ▲ or DOWN ▼, enter your SOL bet amount, and confirm the transaction in your wallet. You're in!

5
Wait for resolution

The countdown timer shows how much time is left. When it hits zero, the market resolves automatically. Winners receive their payout directly to their wallet within seconds.

EMBEDDED WALLETS
If you log in with email or social, Privy creates an embedded Solana wallet for you automatically. You can fund it by sending SOL to the address shown in your wallet panel.

HOW MARKETS WORK

Every prediction market on PULSE5 follows the same lifecycle:

CREATED
Opening price recorded, market opens
ACTIVE
5-min betting window is open
RESOLVING
Final price fetched from oracle
RESOLVED
Winners paid out automatically

MARKET CREATION

  • ▸Automatic — Every 30 seconds, PULSE5 scans bags.fm for new token launches and creates markets automatically. No action needed.
  • ▸Manual — Any user can create a market for any token by searching its Solana contract address in the search bar on the Markets page.
  • ▸Each market records an opening price at creation time using the dual-source price oracle.

RESOLUTION LOGIC

  • ▸When the 5-minute window expires, the engine fetches the final price from the oracle.
  • ▸Final price > opening price → UP ▲ bettors win
  • ▸Final price < opening price → DOWN ▼ bettors win
  • ▸Final price = opening price → All bets refunded (rare tie)
  • ▸Oracle failure → Market cancelled, all bets refunded

PLACING BETS

ONE BET PER MARKET
You can only place one bet per wallet per market. Once placed, bets cannot be changed or cancelled. Choose your direction carefully.

DIRECTIONS

▲ UP

You predict the token price will be higher than the opening price when the 5-minute window closes.

▼ DOWN

You predict the token price will be lower than the opening price when the 5-minute window closes.

BET LIMITS

0.01 SOL
MINIMUM BET
1 SOL
MAXIMUM BET
1 per wallet
BETS / MARKET

PAYOUT CALCULATION

PULSE5 uses a parimutuel betting model — losing bets fund the winning pool. Payouts are proportional to your share of the winning side.

PAYOUT FORMULA
your_payout = (your_bet / total_winning_pool) × total_pool × (1 − house_fee)
house_fee = 0.05 (5%)

WORKED EXAMPLE

Total UP pool0.5 SOL
Total DOWN pool0.3 SOL
Total pool0.8 SOL
Your UP bet0.1 SOL
Price went ▲ UP — you win!
Calculation(0.1 / 0.5) × 0.8 × 0.95
Your payout0.152 SOL (+52%)
HOUSE FEE
A 5% fee is deducted from the total pool before payouts are distributed. This fee funds PULSE5 development and ongoing operations.
EDGE CASE: ONE-SIDED MARKET
If all bets are on the same side and the losing side has zero bets, winners receive their original bet back (no profit possible from an empty opposing pool).

PRICE ORACLE

PULSE5 uses a dual-source oracle system to ensure reliable and accurate price data at both market creation and resolution time.

PRIMARY: BAGS.FM

Real-time price data fetched directly from the bags.fm DEX API. This source is always queried first and preferred when available.

FALLBACK: DEXSCREENER

Aggregated price data from all major Solana DEXes via the DexScreener API. Used when the bags.fm feed is unavailable or returns no data.

  • ▸Both sources are queried in parallel to minimize latency.
  • ▸The bags.fm price is used when available and positive.
  • ▸DexScreener is used as fallback if bags.fm returns null or fails.
  • ▸If both sources fail, the market is cancelled and all bets are refunded.

SUPPORTED TOKENS

Any Solana token with an active price feed can have a prediction market on PULSE5.

  • ▸bags.fm tokens — All tokens launched on the bags.fm platform are natively supported with real-time price feeds.
  • ▸PumpFun graduates — PumpFun tokens that have graduated to major Solana DEXes are supported via DexScreener.
  • ▸Any SPL token — Search any Solana contract address. If a price feed exists on bags.fm or DexScreener, a market can be created.
LIQUIDITY REQUIREMENT
A token must have sufficient liquidity and an active price feed for a market to be created. Very new tokens or tokens with no DEX liquidity may not have a price feed. If you search for a token with no feed, PULSE5 will show an error.

FAQ

YOU'RE READY TO PLAY

Connect your Solana wallet and make your first 5-minute prediction.

LAUNCH APP