Embed Widget

New

Add live prediction markets to any website with a single script tag. Real-time prices, 24h sparkline, zero dependencies.

Quick Start Size Variants Configuration Advanced

Quick Start

One line of HTML. Paste the snippet below into your page and replace the market address with the one you want to embed.

HTML

<script src="https://www.flipcoin.fun/embed.js"
  data-market="0x..."
  data-size="card"
  data-theme="dark">
</script>

How it works

The script reads data-market from the tag
Creates a sandboxed iframe pointing to /api/embed/{address}
The widget loads with live prices and updates every 60 seconds

The iframe is sandboxed with allow-scripts allow-same-origin allow-popups. No access to your page's DOM or cookies. The “Trade on FlipCoin” link opens in a new tab.

Size Variants

Choose a size that fits your layout. Click to preview each variant live.

Default. Shows question, YES/NO prices, sparkline, and volume. Best for blog posts and dashboards.

Theme:

Compact

400×60

Single-line ticker — perfect for sidebars, footers, or inline mentions.

Compact

Card

420×280

Default. Shows question, YES/NO prices, sparkline, and volume. Best for blog posts and dashboards.

Card

Full

600×420

Large widget with sparkline chart, volume, deadline, and CTA button. Great for dedicated embed sections.

Full

Your snippet

HTML

<script src="https://www.flipcoin.fun/embed.js"
  data-market="0x89419ea26297e6de50f288cf2891424f89893e94">
</script>

Default values are omitted. data-size defaults to card, data-theme defaults to dark.

Configuration

Attribute	Required	Default	Description
`data-market`	Required	—	Market contract address (`0x...`, 42 chars)
`data-size`	Optional	`card`	`compact` \| `card` \| `full`
`data-theme`	Optional	`dark`	`dark` \| `light`

Finding a market address

Open any market on flipcoin.fun and copy the 0x... address from the URL. For example: flipcoin.fun/market/0x89419ea...

Advanced

Direct iframe

If you prefer to create the iframe yourself instead of using embed.js, use the URL directly:

HTML

<iframe
  src="https://www.flipcoin.fun/api/embed/0x...?size=card&theme=dark"
  width="420" height="280"
  style="border:none;border-radius:14px;max-width:100%"
  loading="lazy"
  sandbox="allow-scripts allow-same-origin allow-popups"
  title="FlipCoin Market">
</iframe>

Multiple widgets

Add multiple script tags for different markets. Each one creates its own iframe:

HTML

<script src="https://www.flipcoin.fun/embed.js" data-market="0xaaa..."></script>
<script src="https://www.flipcoin.fun/embed.js" data-market="0xbbb..."></script>

Security

The widget runs in a sandboxed iframe — no access to your page's DOM, cookies, or storage
All user-generated content is HTML-escaped to prevent XSS
Price updates use textContent (safe DOM API), never innerHTML
CSP headers restrict the widget to same-origin scripts and connections

Caching

Widget HTML is cached for 30 seconds at the CDN level with a 120-second stale-while-revalidate window. Live prices refresh via client-side polling every 60 seconds.

Responsive

All sizes have max-width: 100% set automatically, so they shrink on smaller screens. The widget is best viewed at its native dimensions or wider.