vol. 26 · ed. wc

documentation

how parlayz works.

wallet, parlays, settlement, fairness. everything you need to understand before you click place bet — and everything any auditor would want to verify after.

01 / wallet

the wallet model

custodial in name only. you control your phantom or backpack; we just manage an in-app balance for fast bet placement.

on first connect, the server mints a deterministic deposit keypair tied to your wallet, encrypted at rest with an aes-256 secret. you deposit sol to that address — credited to your in-app balance once confirmed on chain. every bet is a database write against that balance; no signature needed per wager.

withdrawals are server-signed transfers back to the wallet you connected. you remain the only owner of your phantom seed phrase. parlayz never sees it.

  • phantom / backpack via @solana/wallet-adapter
  • sign-in with solana (siws) for session — no email, no kyc
  • deposit address shown on /wallet, settles on-chain
  • withdrawals: <2s after click. server signs the transfer.

02 / parlays

cross-vertical parlays

every leg multiplies. one settles wrong and the ticket dies. that is the entire point.

what's unusual about parlayz: a leg can be a world cup moneyline (sports), an anytime-scorer prop (sports), a champions league spread (sports), and a $wif closes-higher-today (pumpfun) — on the same ticket.

odds multiply: 1.85 × 2.10 × 2.40 × 1.95 = 18.18×. stake 0.50 sol → potential 9.09 sol.

  • min 2 legs, max 10 legs per ticket
  • no correlated legs (e.g. same-game ml + ml)
  • each leg settles independently; payout only when all hit
  • single-game parlays use uncorrelated lines (ml + total + scorer)

03 / settlement

settlement & resolution

markets close at kickoff (sports) or end of day utc (pumpfun close-higher) or fixed timestamp (futures).

after the result is final on the source feed, the resolver settles every position in the same transaction and credits winners.

resolution feeds: api-football for goals & match results, the-odds-api for cross-checking, dexscreener (with a 60-second twap) for pumpfun close prices. ambiguous results void the leg and refund pro-rata.

  • sports: settled within 5 minutes of match end
  • pumpfun close-higher: settled at 00:00 utc
  • voids return stake to balance; parlay continues with adjusted odds
  • all settlements logged on /portfolio with a bytes-on-disk audit trail

04 / fairness

fairness & house edge

every market carries a published vig. we never adjust odds against a specific user. we never delay a bet to fade a hot streak.

for sports markets, displayed odds are the consensus median across our bookmaker feed minus ~3–5% margin.

for pumpfun synthetic markets, the vig is exactly 5% baked into every outcome symmetrically — so the book has positive expected value on every wager, but the bettor still pockets the full multiplier when their pick lands.

  • sports vig: ~3–5% (sourced from regulated eu/uk books)
  • pumpfun vig: exactly 5% — symmetric, published, never hidden
  • no per-user odds adjustments. no delayed placement.
  • rng-driven markets (none in v1) would publish their seed.

05 / data

data sources

every fixture, every price, every player stat is pulled from a live api. no mock data. when an api key is absent the page renders an empty state with setup instructions — never a fake number.

  • the-odds-api — wc 2026 fixtures + h2h/spread/totals + outrights
  • api-football — club fixtures, group standings, live scores
  • football-data.org — current-season top scorers (pl, la liga, ucl)
  • dexscreener — pumpfun trending coins, mcap, volume, liquidity
  • coingecko — sol spot price for ui conversions

faq

questions, answered.

is this licensed?+

parlayz operates as a smart-contract-settled book on solana. regulatory status is jurisdiction-dependent — check your local laws.

what's the minimum bet?+

0.01 sol per leg. parlays inherit the minimum from their largest leg.

can i export my history?+

yes. /portfolio has a csv download with timestamps, stakes, payouts, and on-chain tx hashes for every deposit/withdrawal.

what happens if an api goes down?+

open markets stay open. new markets stop generating until the feed returns. settled positions stay settled — they're written to the database, not the api.

is there a mobile app?+

web is the app. responsive down to 320px. install via your browser's add to home screen.

how do you make money?+

the published vig on every market. ~3-5% on sports, exactly 5% on pumpfun. no deposit/withdrawal fees beyond solana network costs.

questions we missed?

ping @parlayzdotfun. or read the roadmap.