# Mr. Doge

> Real-time sports odds, live match data, and AI-powered predictions via a typed SDK with native WebSocket support.

## SDK Docs

- [Authentication](https://mrdoge.co/docs/authentication): API keys for servers and short-lived JWTs for browsers, in full detail.
- [Introduction](https://mrdoge.co/docs): The Mr. Doge SDK gives you live odds, AI picks, and market data across every major sport. One typed client, two transports, every framework.
- [Installation](https://mrdoge.co/docs/installation): Pick the package that fits your runtime, server, browser, or edge.
- [Quickstart](https://mrdoge.co/docs/quickstart): From zero to streaming live matches in five minutes.
- [Error handling](https://mrdoge.co/docs/concepts/errors): Typed error classes, abort signals, and rate-limit recovery.
- [Pagination](https://mrdoge.co/docs/concepts/pagination): Keyset cursors, the listAll helper, and progressive rendering for large result sets.
- [Tiers & limits](https://mrdoge.co/docs/concepts/tiers): What each plan unlocks, from methods to request volume and concurrent subscriptions.
- [Transports](https://mrdoge.co/docs/concepts/transports): HTTP for one-shot reads, WebSocket for live subscriptions, and how the client picks for you.
- [Cloudflare Workers](https://mrdoge.co/docs/guides/cloudflare-workers): Edge-runtime SDK with @mrdoge/http, zero Node dependencies.
- [Express](https://mrdoge.co/docs/guides/express): Express middleware and route handlers using the SDK.
- [Framework Guides](https://mrdoge.co/docs/guides): Drop the SDK into your stack, whether that's Next.js, Node, Express, Nest, React Native, or edge runtimes.
- [NestJS](https://mrdoge.co/docs/guides/nestjs): Injectable Mr. Doge service for clean DI inside Nest modules.
- [Next.js](https://mrdoge.co/docs/guides/nextjs): Full-stack Next.js with route handlers for token minting and browser-side subscriptions.
- [Node.js](https://mrdoge.co/docs/guides/node): Plain Node, for scripts, cron jobs, bots, and anything that just needs the SDK.
- [React Native](https://mrdoge.co/docs/guides/react-native): Mobile app integration with token persistence and screen-aware subscriptions.
- [Images](https://mrdoge.co/docs/reference/images): Public CDN endpoints for team and region logos, cached, immutable, no auth required.
- [Matches](https://mrdoge.co/docs/reference/matches): List, get, search, and subscribe to live matches across every major sport.
- [Odds](https://mrdoge.co/docs/reference/odds): Live order books for a single match, one-shot snapshots or streaming deltas.
- [AI Recommendations](https://mrdoge.co/docs/reference/recommendations): Edge-and-confidence-scored bet recommendations with reasoning attached.
- [Regions & Competitions](https://mrdoge.co/docs/reference/regions-competitions): The geographic and competition catalogue underpinning matches and teams.
- [Subscriptions](https://mrdoge.co/docs/reference/subscriptions): Lifecycle, events, and cancellation for live WebSocket subscriptions.
- [Teams](https://mrdoge.co/docs/reference/teams): List, search, and look up teams, with form data.
- [Tokens](https://mrdoge.co/docs/reference/tokens): Mint short-lived JWTs from your backend so browsers can use the SDK safely.

## UI Components (mrdoge-ui)

> Not an npm package. mrdoge-ui is a shadcn/ui-compatible registry:
> components are copy-paste source code, installed one at a time with
> `npx shadcn@latest add https://mrdoge.co/r/<component>.json`. Browse
> the full list, live previews, and props at https://mrdoge.co/ui.

- [Introduction](https://mrdoge.co/docs/ui): Open-source React components for sports apps, distributed as source code through a shadcn/ui-compatible registry.
- [Match Detail](https://mrdoge.co/docs/ui/blocks/match-detail): Match Highlight header plus a Timeline/Odds/Stats tab strip below it.
- [Matches Feed](https://mrdoge.co/docs/ui/blocks/matches-feed): Today's matches, grouped by region. An accordion per region, with competition sub-groups inside once opened.
- [Bet Slip](https://mrdoge.co/docs/ui/components/bet-slip): Panel for selected picks, single or parlay mode, with an optional stake input and conflict warnings.
- [Entity Image](https://mrdoge.co/docs/ui/components/entity-image): Team or region logo, unstyled. Falls back to initials when the image is missing.
- [Match Card](https://mrdoge.co/docs/ui/components/match-card): Compact match row with teams, score or kickoff time, status, and an optional odds row.
- [Match Highlight](https://mrdoge.co/docs/ui/components/match-highlight): Detailed match header for a match page, teams, score, live clock, cards, and corners.
- [Match Timeline](https://mrdoge.co/docs/ui/components/match-timeline): Chronological feed of match events. Goals, cards, penalties, and half/full-time, most-recent-first.
- [Odds Selector](https://mrdoge.co/docs/ui/components/odds-selector): Labeled odds card for a market, selectable options with price movement and suspended states.
- [Stats List](https://mrdoge.co/docs/ui/components/stats-list): Generic home/away match stats comparison bars, one row per stat, sport-agnostic.
- [useOddsMovement](https://mrdoge.co/docs/ui/hooks/use-odds-movement): Diffs each line's price against its previous snapshot, so an Odds Selector can color a price green or red as live odds change.
- [Installation](https://mrdoge.co/docs/ui/mrdoge-sdk/installation): Set up @mrdoge/react, the shared-cache hooks package every live example on this site is built on.
- [Usage](https://mrdoge.co/docs/ui/mrdoge-sdk/usage): Adapters mapping real Mr. Doge SDK responses onto mrdoge-ui component props.
- [useLiveMatch](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-live-match): Subscribes to a single match over WebSocket, score, status, and clock update in real time as the match progresses.
- [useLiveMatches](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-live-matches): Subscribes to matches over WebSocket, filtered by sports/regions/competitions. Updates in place as matches start, finish, or change.
- [useMatch](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-match): One-shot fetch of a single match, no live updates, unlike useLiveMatch.
- [useMatches](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-matches): A plain list of matches, not limited to today's most-viewed ones. One-shot, not a subscription.
- [useOdds](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-odds): Subscribes to a single match's odds over WebSocket (Business tier). Pre-live or in-play, every matching market updates in place as odds change.
- [useRegions](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-regions): Every region, with event/competition counts when filtered. One-shot, not a subscription.
- [useTrendingMatches](https://mrdoge.co/docs/ui/mrdoge-sdk/hooks/use-trending-matches): Today's most-viewed matches, ranked server-side by views. One-shot, not a subscription.

## Blog

- [Build a Live Sports Dashboard in 30 Minutes with Mr. Doge](https://mrdoge.co/blog/live-sports-dashboard-30-minutes): A hands-on walkthrough — live matches, real-time score updates, and a working React dashboard using the Mr. Doge SDK and mrdoge-ui.