# API Overview Poppin puts **prediction markets** directly on your pages. With a single script, the right market shows up next to the content your users are already reading — and they can trade it without leaving your site. **What Poppin does** * Reads what each page is about and brings up a **relevant prediction market** * Markets appear **automatically** — no setup per page * Looks **native to your site** — matches your branding, not a third-party widget * Users **trade right there** — read, tap Yes or No, done **Who this is for** Poppin is built for platforms that want to turn readers into participants. Common use cases: * news and media sites * trading and market platforms * sports, finance, and crypto content * any high-traffic site where people form opinions # Quick Start (Embed in 5 Minutes) **Step 1 — Verify your domain** We verify your domain first, for security. **Step 2 — Get your Poppin ID** Once verified, you get a unique ID tied to your platform, so activity is tracked correctly. **Step 3 — Pick your venue** Choose which prediction market venue to use: **Polymarket**, **Kalshi**, or **Hyperliquid (HIP-4)**. We bring the relevant markets from there. **Step 4 — Pick your style** Choose colors and layout to match your site. Keep it minimal or fully branded — the markets should feel like part of your platform. **Step 5 — Copy and paste the script** Add the script to your site, inside the `` or right before the closing `` tag.
**Step 6 — Go live** Open your site. Relevant markets appear automatically on each page. **Notes** * ✅ **No backend setup required** * ✅ **Users don't need an extension** * 🛡️ **Works across all major browsers** # How It Works You don't pick the markets. We do. Poppin reads the content of each page — the topic, the names, what it's about — and brings up a prediction market that fits. A page about an election surfaces an election market. A page about a game surfaces a market on the game. It happens automatically, on every page, with no work from you. You choose the **venue** (Polymarket, Kalshi, or Hyperliquid). We handle matching the right market to the right page. Your users read the page, see the market, and tap Yes or No to trade — all without leaving your site. # What You Earn Poppin takes a **1% fee on every trade** made through your site. You earn a share of that — a cut of the volume your traffic generates. The more your users trade, the more you make. No caps, no per-page work, no managing anything. It runs on traffic you already have. Readers who would have just scrolled past now have something to act on, and every trade adds up. ## # Customization * **Style settings** * **Full color control:** set your primary, secondary, and accent colors, including text and buttons — so markets match your site. * **Page-level control:** choose where Poppin appears. Exclude it from any pages you want. * **Native look:** markets render as part of your platform, not as a third-party box. **Live preview** Preview your setup in light and dark mode before going live. **What this means for you** * Your platform keeps its look and feel * Everything stays on your site * No sending users anywhere else ## # Security & Privacy * **No KYC or personal data required** Users can browse and interact without handing over personal information. * **No backend access** Poppin runs on the frontend. Your servers and databases stay untouched. * **Funds go through Poppin, not you** Users top up with Poppin directly. You never touch funds, handle payments, or take on that responsibility. * **Content stays on your domain** Everything is scoped to your site. You control what appears where. * **Privacy-friendly by default** No cookies or third-party tracking out of the box. # Copy of Performance Impact Poppin is built to be fast, efficient, and invisible to your core site performance. * **Lightweight script:** The main script is \~24 kB gzipped — significantly smaller than tools like Intercom or Crisp (\~100-150 kB). * **Async loading:** It loads in the background without blocking your page rendering. * **No backend dependency:** The embed works entirely on the frontend. No server-side setup required. * **No layout shift:** It runs as a passive layer, without interfering with your existing DOM or causing reflows. # Support & Contact Need help with integration or custom setups? Email: # Introduction Poppin lets you embed a real-time social layer directly on top of your website — with no backend integration required. You can also use Poppin as a browser extension to instantly access this layer across any site, but this documentation focuses on the API integration. This guide walks you through setting up the widget, customizing its behavior, and using the Poppin dashboard for configuration and analytics. # API Features Overview The Poppin widget enables: * Real-time chat and threaded posts on your site (with optional per-URL customization) * Site-wide announcements * Visual and behavioral customization to match your platform * Full control via the dashboard — no backend API access needed # Dashboard Features The Poppin Dashboard allows you to: * View analytics (users, messages, posts, logins, views) * Send announcements * Assign badges to users * Moderate reported content Everything is managed through the UI — no extra API setup needed. # FAQ **Do I need a backend?**\ No — only a frontend script is required. JWT setup for logged-in users is optional. **Is Poppin GDPR compliant?**\ Yes — data is stored only for users who actively interact. Authentication is handled client-side. **Can I hide Poppin on certain pages?**\ Yes — just don’t include the script on pages where you don’t want it active. **What’s the difference between the extension and API?**\ The extension lets anyone use Poppin across any site. The API is for platforms that want to embed Poppin natively. # Moderation, Security & Privacy * Mesajlar nasıl saklanıyor? * Kullanıcı verisi tutuluyor mu? * Kişisel veriler tutuluyor mu? * Spam ve küfür filtresi var mı? * Yorumlar silinebilir mi / kontrol edilebilir mi? * GDPR / cookie handling varsa bunlara dair not !!Moderation tools for your team