# Voi.Bet

> Trade at the price you want. A new kind of sports betting environment.

## Overview

Voi.Bet gives bettors more control over their odds. Choose an outcome and stake as usual, then take the available odds or request your own price. Bets connect with other bettors when compatible prices and stakes are available.

## Key Features

- **Your Price**: Take the available odds or set the price you want for your selection.
- **Connected Picks**: Orders can create prices for other outcomes in the market, and bets connect automatically when compatible prices and stakes are available.
- **No KYC for Accounts**: Creating or using a Voi.Bet account does not require identity verification.
- **Clear Returns**: No hidden fees or commissions. The price you ask for is what you get.
- **In-Play betting**: Bet on live events with real-time odds.
- **Order Control**: Follow matching status and cancel the unmatched part of an open order.
- **Multi-Crypto Funding**: Instant USDC deposits and withdraws on Solana with seamless cross-chain deposits (BTC, ETH, SOL, USDT, and more).

## Sports & Markets Covered

- **Football (Soccer)**: Premier League, UEFA Champions League, La Liga, Serie A, Bundesliga, and top worldwide leagues.
- **Basketball**: NBA, EuroLeague, and other top leagues and tournaments.
- **Tennis**: ATP, WTA, Grand Slam, and many more.
- **Politics**: Elections and other political events.
- **Esports**: Dota 2, CS2, and other top esports tournaments.
- **American Football**: NFL and NCAA.
- **Chess**: World Chess Championship, and other chess events.
- **Baseball**: MLB and international leagues.
- **Combat Sports**: MMA / UFC and major Boxing events.
- **Cricket**: International competitions and top tournaments.

## Public APIs (Read-Only)

Base URL: `https://voi.bet`

- `GET /api/categories` - Top-level categories (`SPORTS`, `ESPORTS`)
- `GET /api/subcategories` - Sports and disciplines (Football, Basketball, Tennis, etc.; provides `subcategoryIds`)
- `GET /api/event-groups` - Leagues and tournaments (provides `eventGroupIds`)
- `GET /api/events` - Fixtures and match schedules (key params: `active=true`, `size` [default 100, up to 2000], `page`, `eventGroupIds`, `subcategoryIds`, `fromDateTime`)
- `GET /api/markets` - Available betting markets for events (`?eventIds=ID1,ID2`, key params: `size` [default 100, up to 2000], `page`, `statuses=Open`)
- `GET /api/market-prices` - Current odds and liquidity (`?marketIds=ID1,ID2`, Up to 250 market IDs per request)
- `GET /api/market-price-ladder` - Valid odds ladder increments
- `GET /api/stream` - WebSocket stream (`wss://voi.bet/api/stream`) for real-time odds and price snapshots

### How to Fetch Odds

1. **Find Events**: Query `GET /api/events?active=true&size=2000` (always use `active=true` to fetch open events; `size` defaults to 100 and accepts up to 2000 to avoid pagination via `page=`; filter further with e.g. `eventGroupIds` or `subcategoryIds`).
2. **Get Markets**: Query `GET /api/markets?eventIds={eventId}&size=2000` (supports comma-separated IDs; Up to 400 eventIDs per request; `size` accepts up to 2000 markets).
3. **Fetch Odds**: Connect to `wss://voi.bet/api/stream` and send:
   `{"action":"subscribeMarkets","marketIds":["ID1","ID2"]}`

- **Limits**:
  - Rate limit: 50 requests per 10 seconds per IP address across `/api`.
  - WebSocket stream: Up to 500 market IDs per connection, max 5 concurrent connections per IP.

## Platform Links

- [Main Platform](https://voi.bet): Browse active events, markets, and current odds.
- [Betting Rules](https://voi.bet/betting-rules): Market settlement rules and betting guidelines.
- [FAQ](https://voi.bet/faq): Frequently asked questions regarding order matching, funding, and platform features.
- [Terms of Service](https://voi.bet/terms-of-service): Terms and conditions for using the platform.
- [Privacy Policy](https://voi.bet/privacy-policy): Privacy and data handling policies.
- [Support](https://voi.bet/support): Customer support and assistance.