FAQ

CoinRanker is a crypto prediction game built around leagues. Someone curates 5–10 coins and a deadline. Everyone else makes one set of calls — a price, a valuation, or a one-shot $100,000 portfolio — then waits. When the clock hits, we score the field, rank the board, and pay the paid ranks of any pot (top half by default).

That contest is the product. Forecasts, crowd charts, and history tools sit around it; they don't decide who won.

A league is a closed contest with one finish line.

• The creator picks 5–10 coins, a league type, and when results land — anywhere from 30 minutes to 3 months. Coins can be CoinGecko names or a DEX pair pasted as a contract address.
• Sign in, then join while the league is open. Public leagues are listed on the leagues page. Private leagues need an invite code and never appear in the public catalog.
• You can see who entered. Individual picks stay hidden until results, so copying isn't a strategy.
• You can change your entry until the deadline. After the first quarter of the league, joining late or changing a coin costs score weight — see edits and penalties.
• At the deadline we snapshot each coin, score every entry, and lock the ranking. Ties go to whoever last updated their entry earlier.

Every league is one of three modes. The creator chooses; every player in that league is scored the same way.

• Price — call the USD price of each coin at the deadline. Closest on a log scale wins.
• Market cap— call each coin's valuation, not its price. For DEX tokens we freeze an estimated supply when the coin is added (DexScreener market cap, or fully diluted value if market cap is missing). At resolve we multiply that frozen supply by the pool price. Supply does not move mid-league; only price does.
• Portfolio — split a fake $100,000across the curator's coins. This is not a trading competition: there is no buying, selling, or scalping through the window. You submit a one-shot book — how you would allocate the money once — and that book is revalued when the league ends. Highest weighted value ranks first. Lock a slice so the rest redistributes without breaking 100%. CoinGecko and DEX coins can sit in the same league; each keeps its own price source. Fees and prizes work like every other league.

Each coin is scored from 0–100 on closeness:

• An exact call is 100.
• Being off by 2× — twice as high, or half as low — is 0.
• In between we use a log scale, so a 10% miss costs the same whether the coin is $1 or $50,000.

That accuracy is then multiplied by that coin's late-entry weight. Your league score is the averageof those weighted coin scores. Missing a coin, or a coin we couldn't resolve, scores 0 for that slot.

Portfolio leagues ask a different question: if you had to place $100,000 across these coins once, how would you split it?

It is not a trading competition. Nobody is placing orders over the life of the league. There is no cash on the sidelines — the full $100,000 must be allocated. You submit one book. At resolve, each slice is revalued from the price when you set it to the price at the deadline. The player with the highest weighted portfolio ranks first.

You can still change your mix until the deadline. A change is not a trade through the move:

• Cost basis — a slice you change starts from the live price at that moment. A pump you already missed is not credited. Untouched slices keep their original basis.
• Late-entry weight— the same curve as price and market-cap leagues. Change a slice after the free window and only that slice's final dollars are discounted. Leave it alone and it keeps its earlier weight.

The dollar total you see is the full mark-to-market book. Ranking uses the weighted total. That weighted value is divided by 1,000 to make a score, so a break-even $100,000 book at full weight is 100.

Yes. Entries stay open until results. You can join or edit until the deadline — but late moves are not worth as much as early ones.

• The first 25% of the league is a free window. Join or edit at full weight.
• After that, weight falls sharply toward 0 as the deadline approaches, and hits 0 at resolve. Joining in the last moments is almost worthless.
• Only coins you actually change are re-timestamped. Untouched coins keep the weight they already earned. Joining late applies the current weight to every pick you submit.
• The league page shows a late-join or late-edit note when the penalty is on, including the weight your next save would get.

Same rules in all three modes. In portfolio, a changed allocation also gets a new cost basis, so you don't get the price move you sat out.

If two players land on the same score, the earlier last update wins.

Leagues can charge gold coins, USDC, or both — or be free. Scoring and ranking are the same; only the pot (or pots) changes.

• Free — no entry fee, no pot. You still rank. Qualifying public leagues still award profile points and badges.
• Gold coins — in-app chips (claim a daily stack from the nav), not a cryptocurrency. The creator can charge a coin fee; those fees become the pot. 25% stays with the platform; the rest pays winners. Winnings credit your in-app balance automatically. A USDC league can also charge gold coins (for example to gate a donated USDC pot).
• USDC — real dollars on Base. Join from a wallet; we can provision an embedded one, and gas on that wallet is sponsored. Some regions are blocked — you will see Your region is not supported, and gold-coin-only leagues still work. USDC entry can be $0when the prize is donated; you still get a wallet so you can claim. After resolve, winners claim USDC on the league's claim page with the same wallet that entered. If a USDC league is cancelled, paid USDC entries can refund in full once the on-chain cancel lands. Claim and refund are not geofenced for people who already paid. Gold-coin fees on a cancelled USDC league return to balances. A platform cut is snapshotted at create. Hosts can also take an optional host fee (default 0%) paid to their wallet at settle.

Paid pots go to the paid ranks — top half of the field by default. Hosts (and admins) can cap that to 1st only, top 3, top 5, or top 10 so a sponsored pot concentrates on the podium. 1st takes the largest slice, then 2nd, then 3rd. After the podium, paid places are grouped so the last paid rank still gets a share when the pot can cover it. Unpaid ranks do not get a payout.

Gold-coin pots can be seeded without entering: an admin donates coins into the pot (house mint — you do not spend a player balance). USDC pots can be seeded the same way from the admin leagues tab: that calls on-chain donate() and pulls USDC from the settler wallet. It is not an entry and cannot be refunded. Rake still applies to the full pot (entries + donations) at settle.

We snapshot each coin near the deadline, score every entry, and lock the board. Picks become visible. You get a personal result card: Champion, podium, top 5, top 10, top half — or a consolation line if you finished outside the paid ranks. Share that card; it has a preview image for X.

Gold-coin prizes hit your balance on their own. USDC prizes you claim from the league claim page. If you finished in the unpaid half, there is nothing to claim. If the league was cancelled and you never registered on-chain, there is nothing to refund.

Separate from the pot. Profile points come only from public leagues that finish with 21+ players (bots count toward that 21).

• When a qualifying league resolves, your league score is added to a running total — closeness 0–100 for price and market cap, or weighted portfolio value ÷ 1,000 for portfolio (break-even ≈ 100 at full weight).
• More qualifying leagues, more points. A single great finish does not reset a career of quiet ones.
• Private leagues and public leagues under 21 players still rank and can still pay a pot. They do not add profile points or badges.

In a qualifying public league (21+ players), a top-five finish earns one badge — only the highest tier counts, they don't stack:

• Champion — 1st place
• Podium — 2nd or 3rd
• Top 5 — 4th or 5th

A Champion does not also receive Podium and Top 5 for the same league. Badges show on public league boards and on your profile.

Players are ranked by cumulative points from qualifying public leagues. Ties break on Champions earned, then number of qualifying leagues played. You need at least one resolved qualifying result to appear.

For leagues, yes — sign in with Google, email, or a wallet so results attach to your profile. You can still publish a top-20 forecast without signing in.

You can build a future crypto top 20 and share the link — useful for pulling friends into a league. Search CoinGecko to find and add coins, type a predicted price (market cap stays in sync via circulating supply), drag to reorder, and remove anything you don't want. The shared page is a CoinGecko-style markets table (#, coin, price, vs today, 1h / 24h / 7d, market cap, 7-day chart) for that future date. The same table (top 10) is the large image X / Discord / iMessage show when someone pastes the link. The short-window moves and sparkline are illustrative so the snapshot looks live. These forecasts are not scored and never add profile points or leaderboard rank. They can still feed the crowd Consensus view.

Consensus averages everyone's predicted prices for the same target month, converts each average to market cap via circulating supply, then sorts. Crowd # is that order; Mentions is how many people included that coin. Disagreements highlight where the crowd's expected rank differs a lot from today's live ranking.

Every account has a personal invite link on your profile (/join/yourname). Share it on X; the card tells people you both get coins. The first time someone signs up from that link (or ?ref=), they are attributed to you. Referral coins are set in admin rewards (default 200 each side). Self-referrals and bots do not pay.

Compare projects a coin's price at a share of another asset's market cap. History walks past monthly top-100 snapshots. Neither is part of league scoring.

Live rankings and prices come from CoinGecko, refreshed about every 5 minutes on the home page. DEX league tokens use DexScreener for live prices and valuations, and GeckoTerminal pool candles for historical resolution prices. When a league hits its deadline we snapshot each coin within ±5 minutes of that timestamp (CoinGecko 5-minute chart points, or GeckoTerminal 1-minute / 5-minute candles for DEX pools). The fetch fires as the league ends and retries within the first minute if a candle is still publishing. Live quotes are used only in those first 5 minutes if history is not ready yet. Historical charts and compare scenarios use our curated market datasets.