Yoinx — Win Coupons, Prizes, ICP & Crypto

Rules & economy

How to play

Fast auction energy. Sneak before you yoinx; slap after they try. If you get slapped — yoinx again… and again. Tables host 2–25 players worldwide.

The clock

Join a table

Practice is free. Prize and item tables need an entry fee. Private tables need a code. The game starts when the minimum player count is met.

YOINX to grab

Spend 1 Yoinx tool to become the current holder and reset the timer to 10 seconds. You can’t yoinx if you already hold.

SLAP to defend

Register as the slapper (often while you hold) so the next enemy yoinx fails. Only one slapper at a time — you can’t override an existing slap.

SNEAK the clock

Arm Sneak, then Yoinx — that grab holds for 3 seconds instead of 10. Sneak alone does not move the clock.

Win at zero

Whoever holds when the timer hits 0 wins the prize (minus a small service fee on ICP pots). Claim on-chain or pick up physical / coupon rewards as listed.

Create tables

Creating a table

Anyone can open a table: pick a game type, set min players (2–25), entry fee, join window, and what the winner takes home — ICP, XFTs, tokens, coupons, gift cards, or real-world items.

Open public

Listed on the live floor for anyone to join.

Invite private

Share a code with your crew or community.

Series mode

First to win 3 games takes the series crown.

List a prize

ICP pot, physical goods, coupons, or Dexsta loot.

Physical items & seller payout

Auction sneakers, bags, headphones, phones, fashion — new or used. The seller sets the item price through entry economics so the table covers the goods when the minimum fills.

Item price

entry fee × min players = item price

Example: $10 entry × 8 min players = $80 covered for the item.

Extra players

each player over min = +50% bonus

Overflow seats pay the seller a 50% bonus on each extra entry — pure upside when the table packs out.

Worked example

You list headphones worth $40. Set entry at $5 and min players at 8 ($5 × 8 = $40). If 12 players join, the first 8 cover the item; the 4 extra entries each add a 50% bonus for the seller on top of covering the goods.

Game types

Practice

Free warm-up tables. Learn tools with zero ICP risk. Hit the admin min Yoinx grabs to count as competed; stay until the timer ends to complete. Min 2 players.

Prize pot

Public tables funded by entry fees. Winner takes the pot (minus ~2.5% service fee).

Private

Invite-only with a join code. Perfect for crews, brands, and private drops.

Coupon

Local business coupons. Geo-fenced so only nearby players can join and redeem.

Physical item

Fashion, gadgets, new or used goods. Seller sets price via entry × min players.

Special / XFT

List Dexsta XFTs, tokens, gift cards, or custom pots as the prize.

Business coupons

Local shops can list coupon tables — free coffee, % off, BOGO, and partner deals. Players snatch the coupon on the clock, then redeem at your location.

Business profile

Geo-fenced

All coupon games are geo-fenced within X miles of the business location — only nearby players can join and redeem.

Radius from store

Local discovery

In-store redeem

Product button

Business embedAny websitePhysical prize tables

Add a Yoinx! button to your products

Any Yoinx business can drop a button on product pages — fashion shops, Gamerholic merch, custom sites. Shoppers click Yoinx! and a live multiplayer table opens for that item. Tables are attributed to your business; the player who clicks is the table creator.

Setup (5 minutes)

Create a business

Profile → Businesses → Add business (name, address). One principal can own multiple shops.

Generate your site key

On that business card, open Yoinx! button. We create a publishable site key (yx_pk_…) and show your business id.

Allow your shop origins

List exact Origins (e.g. https://your-shop.com and http://localhost:3020 for dev). Empty = open (dev only).

Wire env on your site

Copy the env snippet into your product app. Point API/App URL at Yoinx (local :3030 or yoinx.fun).

Ship the button

On each product page, show Yoinx! → call POST /api/create/embed with site key, business id, product title, story, images, and the shopper’s principal.

Env snippet (your product site)

Copy from Profile

NEXT_PUBLIC_YOINX_API_URL=https://yoinx.fun
NEXT_PUBLIC_YOINX_APP_URL=https://yoinx.fun
NEXT_PUBLIC_YOINX_SITE_KEY=yx_pk_…   # from Profile → Yoinx! button
NEXT_PUBLIC_YOINX_BUSINESS_ID=…      # same business UUID

Entry fee (tools)

entry Yoinx = ceil(item $ / $0.10 / min players)

Min players roll 5–25 when the shopper clicks. 1 Yoinx ≈ $0.10 so the pot covers the item when the table fills.

Create API

POST /api/create/embed

Header X-Yoinx-Site-Key. Body: principal, businessId, title, itemName, story, images, minPlayers, entryYoinx. Returns game id → /play/?id=

What shoppers see

Connect II

Same Internet Identity as Yoinx.

Tap Yoinx!

Table opens for that SKU under your business.

Play & win

Fill seats, fight the clock, claim the product.

No secret API key in the browser — site key is publishable

Origin allowlist blocks random sites reusing your key

Works with Gamerholic, custom Next apps, or any product FE

Tools

Buying tools

Each match deals a starter tool inventory. When you need more pressure or defense, buy reloads mid-game or from your wallet.

Yoinx

Grab the hold

Slap

Block a grab

Sneak

Next yoinx holds 3s

Reload price

$0.10

per tool — Yoinx, Slap, or Sneak. Unused purchased tools can be reclaimed after the match.

Prize pots also take a ~2.5% platform service fee from the ICP pot.

Ready to yoinx?

Warm up free, open a table, or snatch something on the live floor.