> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kash.bot/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart Guide
> Get your first Kash embed running in 5 minutes
Get prediction market embeds on your website in under 5 minutes.
## Step 1: Choose a Thread
First, fetch a list of available threads from our API:
```bash cURL theme={null}
curl "https://app.kash.bot/api/threads?status=active&limit=5"
```
You'll get a response like this:
```json Response theme={null}
{
"threads": [
{
"id": "abc123-def456",
"title": "2024 Election Predictions",
"marketCount": 12,
"totalVolume": 1250000,
"status": "active"
}
],
"pagination": { ... }
}
```
Copy the `id` field from the thread you want to embed.
## Step 2: Add the Iframe
Add this HTML to your website, replacing `{threadId}` with the ID from Step 1:
```html HTML theme={null}
```
Replace `your-site-name` in the `source` parameter with your actual website name for proper revenue tracking.
## Step 3: Style the Container (Optional)
Wrap your iframe in a container for better responsive design:
```html HTML theme={null}
```
## Step 4: Add Event Listeners (Optional)
Track user interactions with the embed:
```javascript JavaScript theme={null}
window.addEventListener('message', (event) => {
// Verify origin for security
if (event.origin !== 'https://app.kash.bot') return;
if (event.data.type === 'kash-iframe-ready') {
console.log('Embed loaded successfully');
}
if (event.data.type === 'kash-market-clicked') {
console.log('User clicked market:', event.data.data.marketId);
// Track in your analytics
}
});
```
## Complete Example
Here's a complete, production-ready example:
```html HTML theme={null}
Prediction Markets
Live Prediction Markets
```
## Recommended Dimensions
Different embed types work best at specific dimensions:
| Embed Type | Desktop | Tablet | Mobile |
| --------------------- | ------------ | ------------ | ------------ |
| Thread (20-tile grid) | 100% × 900px | 100% × 800px | 100% × 700px |
| Single Market | 100% × 500px | 100% × 500px | 100% × 400px |
Always use `width="100%"` for responsive design. Only the height needs to be fixed.
## Troubleshooting
### Iframe not loading?
1. **Check the thread ID** - Make sure you're using a valid thread ID from the API
2. **Verify the URL** - The format should be exact: `https://app.kash.bot/threads/{id}/iframe`
3. **Check CORS policies** - Some Content Security Policies may block iframes
4. **Test in incognito** - Ad blockers sometimes interfere with embed loading
### Embed looks broken on mobile?
Reduce the iframe `height` attribute for mobile devices using CSS media queries:
```css CSS theme={null}
@media (max-width: 768px) {
iframe {
height: 700px !important;
}
}
```
### Not seeing revenue sharing data?
Make sure you:
1. Added the `?source=your-site-name` parameter to your iframe URL
2. Contacted [partnerships@kash.bot](mailto:partnerships@kash.bot) to set up your revenue share agreement
3. Waited 24-48 hours for initial tracking data to appear
## Next Steps
Explore all available API endpoints
Learn more about iframe embedding options
View React and vanilla JS examples