> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fieldfunded.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Build a Twitch Esports Odds Overlay for OBS
> Build a Twitch stream overlay showing live esports odds for CS2, LoL, Dota 2, and Valorant. OBS Browser Source integration.
# Build a Twitch Esports Overlay with Live Odds
Show real-time esports odds directly on your stream. Viewers see odds updating live as the game progresses.
## What You'll Use
| SDK Method | Endpoint | Purpose |
| ---------------- | -------------------------- | ------------------------ |
| `getEvents()` | `GET /v1/events` | Find esports events |
| `getLive()` | `GET /v1/live` | Get live esports matches |
| `getEventOdds()` | `GET /v1/events/{id}/odds` | Real-time odds |
| `getScores()` | `GET /v1/scores` | Current map/round scores |
| `getSports()` | `GET /v1/sports` | List esports categories |
## How Twitch Overlays Work
OBS Studio has a "Browser Source" that renders any URL as a transparent overlay on your stream. You build a web page → OBS renders it on top of your game.
## Step 1: Find Esports Events
FieldFunded covers esports under specific sport keys. Check available esports:
```typescript theme={null}
const sports = await client.getSports();
const esports = sports.sports.filter(s => s.is_esport);
// e.g. 'esports-csgo', 'esports-lol', 'esports-dota2', 'esports-valorant'
```
Get live esports matches:
```typescript theme={null}
const liveEsports = await client.getLive({
sport: 'esports-csgo', // CS2
});
```
## Step 2: Build the Overlay Page
```html theme={null}
```
## Step 3: Add to OBS
1. Open OBS Studio
2. Sources → Add → **Browser Source**
3. Point to `http://localhost:3000/overlay.html` (or host it online)
4. Set width/height (300×120 works well)
5. Check "Shutdown source when not visible"
## Rate Limit Math
* Polling every 15 seconds = 2 requests per poll (live + odds)
* Per hour: 240 requests
* 4-hour stream: \~960 requests
* Free tier (10K/month) supports **\~10 full streams per month**
* Starter (\$29): **\~300 streams/month** — more than enough
See live endpoint docs →
***
## Related Guides
* [Build a Discord Bot](/guides/build-discord-bot) — serve odds in Discord
* [Build a Chrome Extension](/guides/build-chrome-extension) — odds overlay on sports articles
* [FieldFunded vs The Odds API](/compare/vs-theoddsapi) — why we have more esports data
Start building in 5 minutes — 10,000 free requests/month
All plans compared side by side