Price the rumour
before the headline.
Punter turns crypto rumours — launches, leaks and CT chaos — into live YES/NO markets. Clean odds, clear terms, fast on-chain payout. This is how it works, and how to build on it.
01 Introduction
Punter is a prediction market for crypto rumours. The moment a launch, leak or listing starts moving on CT, Punter spins it into a market: take YES or NO, and your conviction becomes a live price the whole timeline can trade against.
There is no house moving goalposts and no headline to wait for. Every market ships with unambiguous resolution terms, settles on-chain through a decentralized oracle, and pays winners the moment it resolves — non-custodial, start to finish.
02 How it works
Every market moves through the same four beats:
- Rumour detected. A launch, leak or listing starts moving on CT. Punter frames it as one clean, binary question with a deadline.
- Odds go live. The market opens. YES and NO become a live price set by real order flow — not a poll, not a vote.
- Traders take sides. Anyone can take a position in one click, in the app or through the SDK.
- Oracle settles. When the event resolves, the oracle reads reality, settles on-chain, and winners get paid instantly.
03 Core concepts
| Term | What it means |
|---|---|
| Market | One binary question on a crypto rumour, with a fixed deadline and resolution terms. The minimum unit of Punter. |
| Side | YES or NO. Taking a side opens a position. |
| Odds / price | The live price of YES (0–100¢), set by order flow. NO is 100¢ − YES. |
| Terms | The exact, written condition that decides the outcome. Set before the first bet, never changed. |
| Oracle | The decentralized resolver network that reads reality and settles the market on-chain. |
| Basket | Several markets bundled into one portable position — e.g. a whole launch or leak. |
04 Opening a market
Any rumour with a clean, checkable outcome can become a market. A market needs three things: a question, a deadline, and resolution terms.
# open a market from the CLI punter open \ --market "TOKEN lists on Binance" \ --deadline 72h \ --terms "YES if a spot pair is live on binance.com before the deadline"
05 Taking a side
Find a live market, pick a side, size your position. Fills are sub-second and settle to your own wallet — Punter never takes custody.
// take YES with the SDK const ticket = await punter.bet({ market: "binance_listing", side: "YES", size: "250 USDC", }) console.log(ticket.fillPrice) // 0.68
Odds move, the edge is being early
The earlier you are on a rumour, the better your entry. A market taken at 30¢ that resolves YES pays more than the same call at 80¢ once the crowd has piled in.
06 Settlement & payout
- Terms decide it. The condition is written before the first bet. The oracle just checks whether it happened.
- On-chain & final. Resolution and payout happen on-chain. No withdrawal queue, no house discretion.
- Non-custodial. Funds sit in escrow, not on a company balance sheet. Your keys, your winnings.
- Instant. Winners are paid the moment a market resolves.
Markets settle on Solana, Ethereum, BNB Chain or Base. Settlement is a deployment detail — the oracle is the source of truth.
07 Market baskets
A basket bundles several Single Markets into one portable position — trade a whole narrative instead of one leg.
| Basket | Bundles |
|---|---|
| Launch | Listing · TGE · first-day volume |
| Leak | Partnership · fund flow · insider chatter |
| Airdrop | Snapshot · eligibility · confirmation timing |
A basket resolves atomically: all constituent markets settle together, or the basket voids.
08 SDK quickstart
The Punter SDK plugs markets into any app or bot. Three modes: bet() for a known market, basket() for a bundle, and chat() for natural-language intent.
// install npm i @punter/sdk // connect import { Punter } from "@punter/sdk" const punter = new Punter({ wallet, chain: "solana" }) // read live markets const markets = await punter.markets.live({ tag: "listing" }) // natural-language intent await punter.chat("take YES on the Binance listing")
09 API reference
REST over HTTPS. All responses are JSON. Public reads need no key; writes require a wallet signature.
| Method | Endpoint | Does |
|---|---|---|
| GET | /v1/markets | List live markets (filter by tag, chain, deadline) |
| GET | /v1/markets/:id | One market — odds, terms, volume, status |
| POST | /v1/markets | Open a market (question, deadline, terms) |
| POST | /v1/bets | Take a side (market, side, size) |
| GET | /v1/baskets | List and read market baskets |
| GET | /v1/positions | Your open positions and settled payouts |
# list live listing markets curl https://api.punter.xyz/v1/markets?tag=listing \ -H "accept: application/json"
10 Resolution rules
- Terms are frozen. Once a market opens, its resolution condition cannot change. No moved goalposts.
- Binary only. Every market resolves to exactly one of YES or NO. Ambiguous rumours are framed into a checkable condition first.
- Deadline is hard. If the condition is not met by the deadline, the market resolves NO.
- Disputes. A resolution can be challenged during a short window; the oracle network re-checks against the written terms. Bad resolvers are slashed.
- Voids. If a market was mis-specified, it voids and all positions are refunded — never silently re-interpreted.
11 FAQ
What can become a market?
Anything on CT with a clean, checkable outcome and a deadline: listings, TGEs, airdrops, unlocks, fund flows, mainnet dates, partnership leaks.
Does Punter hold my funds?
No. Positions settle to your own wallet through on-chain escrow. Punter is non-custodial.
Which chains?
Solana, Ethereum, BNB Chain and Base. The oracle is chain-independent.
What does $PUNTER do?
Token utility — fee share for stakers, cheaper trading, market creation, governance and resolver bonds — ships with launch. It is not live yet.
How are fees charged?
A small rake on settled markets funds the protocol and, at launch, flows to $PUNTER stakers. There is no house edge baked into the odds.