# BetGenius

> BetGenius is the sportsbook-operator brand of Genius Sports, a London- and New York-listed sports
> data and technology group. It supplies licensed sportsbooks with official data and odds feeds,
> managed trading and risk (Genius Trading Services), low-latency in-play video (BetVision, Genius
> Live Player), BetBuilder same-game-parlay pricing, and player-engagement marketing (FANHub).
> There is no self-service developer portal: every credential is issued by an integration manager to
> a contracted operator, and the reference documentation lives in a public Confluence space plus a
> public Nextra docs site rather than on a developer portal.

Generated by API Evangelist from the artifacts in this repository. BetGenius publishes no llms.txt
of its own — /llms.txt returns 403 on dap-docs.betstream.betgenius.com and
developer.geniussports.com (both S3 origins) and 404 on www.geniussports.com.

## What is actually callable

- [Booking API V2](https://dataservices.betgenius.com/BookingSystem/swagger/docs/V2): Swagger 2.0, 3 operations — list bookable fixtures, book, un-book. HTTP Basic. Served from BetGenius's own host.
- [Booking API V1](https://dataservices.betgenius.com/BookingSystem/swagger/docs/V1): the same 3 operations on the pre-v2 path; still live.
- [Video Streaming API v3](https://explorer.api.geniussports.com/Video/v3/PRODPRM/swagger-latest.json): Swagger 2.0, 7 operations — list/get fixtures with streams, list regions, and exchange stream ids for authorised HLS/DASH/SRT/VOD playback URLs. OAuth2 bearer + x-api-key. RFC 7807 errors.
- [Genius Live Player](https://dap-docs.betstream.betgenius.com/video-player/web-browser-integration): a CDN script tag, not a package. Talks to the host page over a `geniussportsmessagebus` CustomEvent bus.
- [Ably push feeds](https://geniussports.atlassian.net/wiki/spaces/BID/pages/3990454301/Genius+Sports+Live+Sports+Data+Push+API+via+Ably): pub/sub match state, match events, live statistics and telemetry. Channel access is minted per fixture by a REST call; no AsyncAPI is published.

## Specs in this repository

- openapi/betgenius-booking-v1-openapi.yml — Booking API V1 (Swagger 2.0)
- openapi/betgenius-booking-v2-openapi.yml — Booking API V2 (Swagger 2.0)
- openapi/betgenius-video-v3-openapi.yml — Video Streaming API v3.4.1 (Swagger 2.0)
- openapi/_original/ — the harvested documents, verbatim

## Artifacts in this repository

- authentication/betgenius-authentication.yml — three auth models across three surfaces
- scopes/betgenius-scopes.yml — the matchstateapi/* OAuth scope family
- conventions/betgenius-conventions.yml — versioning, environments, pagination, error envelopes, heartbeat
- errors/betgenius-problem-types.yml — RFC 7807 problems, gateway errors, player error codes 1001-1004
- rate-limits/betgenius-rate-limits.yml — the 10-minute per-sport Booking cooldown, 100 rps Match State ceiling
- lifecycle/betgenius-lifecycle.yml — status page, reliability contract, versioning posture
- sandbox/betgenius-sandbox.yml — UAT hosts and the GeniusPremiumReplay historic-match test feed
- components/betgenius-components.yml — Genius Live Player, BetVision, game trackers
- asyncapi/betgenius-event-surface.yml — Ably channels and the browser event bus
- data-model/betgenius-data-model.yml — Fixture, LiveStream, Delivery, Permission, DMA
- conformance/betgenius-conformance.yml — what the platform does and does not conform to
- packages/betgenius-packages.yml — no SDKs exist; the only distributable is an unpinned CDN loader
- plans/betgenius-plans-pricing.yml — no published pricing; enterprise contract only
- security/betgenius-domain-security.yml — TLS/DNS posture
- skills/ — three agent skills grounded in real operationIds

## Documentation

- [Genius Sports Developer Centre](https://developer.geniussports.com/)
- [BetGenius Integration Documents (Confluence space BID)](https://geniussports.atlassian.net/wiki/spaces/BID)
- [Genius Sports Integration Guide — BetVision and Live Player](https://dap-docs.betstream.betgenius.com/)
- [Booking API reference](https://geniussports.atlassian.net/wiki/spaces/BID/pages/36084721/Booking+API)
- [Platform authentication](https://geniussports.atlassian.net/wiki/spaces/BID/pages/3925901961/Match+State+Platform+APIs+Authentication)
- [Service reliability and availability](https://geniussports.atlassian.net/wiki/spaces/BID/pages/34822535/Service+Reliability+and+Availability)
- [Status page (login required)](https://status.geniussports.com)

## Company

- [Genius Sports — sportsbook products](https://www.geniussports.com/bet/)
- [Genius Sports investors](https://investors.geniussports.com)
- [Newsroom](https://news.geniussports.com)
- [Contact sales — sportsbook](https://www.geniussports.com/contact-sales/sportsbook-contact/)

## Caveats an agent should know

- Nothing here is self-service. There is no signup, no free tier, no public sandbox credential.
- www.betgenius.com does not complete a TLS handshake; betgenius.com now redirects to geniussports.com/bet/.
- No idempotency key exists on any write operation, including the chargeable `book` call.
- No rate-limit response headers are returned anywhere; limits are prose-only.
- The Match State Platform, Statistics and Fixtures APIs run on api.geniussports.com and are
  catalogued under the parent company at all/genius-sports/, not here.