Quick start
Copy the snippet below into any HTML surface. The iframe loads tournaments live from our database, refreshes every 5 minutes, and styles itself to fit your container.
<iframe src="https://trading-tournaments.com/embed/tournaments" width="100%" height="380" frameborder="0" style="border-radius: 8px;"></iframe>URL parameters
| Param | Values | Default | Notes |
|---|---|---|---|
| theme | dark · light | dark | Card colours. Background stays transparent so the iframe blends with the host page. |
| limit | 1–20 | 5 | Number of tournaments to show. |
| country | ISO-3166 alpha-2 | — | e.g. US, GB, VN. Hides tournaments that block this residency. |
| asset | crypto · forex · futures · stocks · options · copy · paper | — | Filter by asset class bucket. |
Examples
Default — top 5 live tournaments (dark theme)
<iframe src="https://trading-tournaments.com/embed/tournaments" width="100%" height="380" frameborder="0" style="border-radius: 8px;"></iframe>Top 10, light theme — for white-background sites
<iframe src="https://trading-tournaments.com/embed/tournaments?theme=light&limit=10" width="100%" height="680" frameborder="0" style="border-radius: 8px;"></iframe>Crypto only, filtered for US residents
<iframe src="https://trading-tournaments.com/embed/tournaments?asset=crypto&country=US" width="100%" height="380" frameborder="0" style="border-radius: 8px;"></iframe>FAQ
Is it really free? Yes. No signup, no API key, no usage limits. We monetize via affiliate links on the tournaments themselves; embed traffic is additive for both of us.
How fresh is the data? Tournament listings cache for 5 minutes. New tournaments published to our admin appear in your embed within that window.
Can I style it? The two themes (dark/light) cover most surfaces. For deeper customization, wrap the iframe in a container with your own border / shadow / heading — the iframe itself stays transparent so it blends naturally.
Will it slow my page down? The iframe streams server-rendered HTML — no client-side JS, no React hydration. Loads in under 200ms on a warm cache. Set loading="lazy" on the iframe if it's below the fold.
Can I track clicks? Every outbound link in the embed carries ?ref=embed so you (and we) can attribute traffic. We don't read anything from the parent page.
Need a different format?
Looking for an API instead of an iframe? Or a richer widget (compare bar, prize ticker, country-aware leaderboard)? Reach out via the partners page and we'll prioritize based on what people ask for.
