> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mrdoge.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Mr. Doge API

> Professional sports betting data and AI-powered predictions for your applications

## Welcome to Mr. Doge!

The Mr. Doge API provides comprehensive, real-time sports betting data with AI-powered predictions and recommendations. Access odds data, live scores, market analysis, and intelligent betting recommendations through a simple REST API.

<Card title="Get Started in 5 Minutes" icon="rocket" href="/quickstart" horizontal>
  Create your API key and make your first request
</Card>

## What You Can Build

Use our API to power betting applications, analytics platforms, prediction models, and more.

<Columns cols={2}>
  <Card title="Betting Analytics" icon="chart-line">
    Build dashboards that track odds movements, identify value bets, and analyze
    betting markets in real-time.
  </Card>

  <Card title="Prediction Platforms" icon="brain">
    Leverage our API to create prediction services and Machine Learning models.
  </Card>

  <Card title="Sports Content" icon="sparkles">
    Use our API with competitions, teams, players and other data to generate
    dynamic sports content.
  </Card>

  <Card title="Live Score Apps" icon="futbol">
    Access real-time scores, match statistics, and live betting markets for
    multiple sports.
  </Card>
</Columns>

## Key Features

<CardGroup cols={2}>
  <Card title="10+ Endpoints" icon="plug">
    Comprehensive API covering events, odds, live data, AI predictions, and bet
    settlement.
  </Card>

  <Card title="Multi-Sport Coverage" icon="trophy">
    Soccer, Basketball, American Football, Baseball, Tennis, Volleyball,
    Handball, and Ice Hockey.
  </Card>

  <Card title="Real-Time Data" icon="bolt">
    Live scores, real-time odds updates, and millisecond-level odds movement
    tracking with Websockets support.
  </Card>

  <Card title="Pay-As-You-Go" icon="coins">
    Credit-based pricing with no monthly fees. Only pay for what you use
    starting at \$29.90!
  </Card>
</CardGroup>

## Popular Use Cases

<AccordionGroup>
  <Accordion title="Sports Betting Applications" icon="mobile">
    Build mobile or web apps that display odds, provide betting recommendations,
    and track user bets. Access our AI predictions to give your users an edge.
  </Accordion>

  <Accordion title="Value Betting Services" icon="bullseye">
    Identify +EV opportunities using our AI value detection. We calculate edge
    percentage, confidence levels, and optimal stake sizes using Kelly
    criterion.
  </Accordion>

  <Accordion title="Betting Analytics & Research" icon="magnifying-glass-chart">
    Analyze odds movements, market efficiency, and betting patterns. Track AI
    performance metrics and ROI by sport and competition.
  </Accordion>
</AccordionGroup>

## How It Works

<Steps>
  <Step title="Create Your Account">
    Sign up at [mrdoge.co](https://mrdoge.co) and you're instantly ready to build — no email verification required
  </Step>

  <Step title="Purchase Credits">
    Choose a credit package starting from \$29.90 for 20,000 credits
  </Step>

  <Step title="Generate API Key">
    Create an API key from your dashboard - it starts with `sk_live_`
  </Step>

  <Step title="Make Requests">
    Authenticate with Bearer token and start fetching odds and AI insights
  </Step>

  <Step title="Monitor Usage">
    Track your credit consumption and API usage in real-time from the dashboard
  </Step>
</Steps>

## Quick Example

Here's how simple it is to get today's soccer matches with live markets attached:

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer sk_live_your_api_key" \
    "https://api.mrdoge.co/v2/matches?sport=soccer&status=upcoming&status=live&locale=en"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.mrdoge.co/v2/matches?sport=soccer&status=upcoming&status=live&locale=en", {
    headers: {
      Authorization: "Bearer sk_live_your_api_key",
    },
  });
  const payload = await response.json();
  console.log(`Found ${payload.count} upcoming matches`);
  ```

  ```python Python theme={null}
  import requests

  headers = {'Authorization': 'Bearer sk_live_your_api_key'}
  response = requests.get(
      'https://api.mrdoge.co/v2/matches',
      params={'sport': 'soccer', 'status': ['upcoming', 'live'], 'locale': 'en'},
      headers=headers
  )
  events = response.json()
  print(f"Found {events.get('count', len(events.get('data', [])))} upcoming matches")
  ```
</CodeGroup>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "42099047",
        "startDateTime": "2025-09-13T11:30:00.000Z",
        "status": "upcoming",
        "homeTeamId": 95450,
        "homeTeam": {
          "id": 95450,
          "name": "Arsenal"
        },
        "awayTeamId": 11045,
        "awayTeam": {
          "id": 11045,
          "name": "Nottingham Forest"
        },
        "sportId": 1,
        "sport": {
          "id": 1,
          "name": "soccer"
        },
        "competitionId": 847,
        "competition": {
          "id": 847,
          "caption": "Premier League"
        },
        "regionId": 6,
        "region": {
          "id": 6,
          "caption": "England"
        },
        "markets": [
          {
            "id": "1432181681",
            "betTypeSysname": "SOCCER_MATCH_RESULT",
            "betItems": [
              {
                "id": "5940732426",
                "code": "X",
                "price": 4.7,
                "isAvailable": true
              },
              {
                "id": "5940732427",
                "code": "2",
                "price": 8.1,
                "isAvailable": true
              },
              {
                "id": "5940732425",
                "code": "1",
                "price": 1.4,
                "isAvailable": true
              }
            ]
          },
          {
            "id": "1432181705",
            "betTypeSysname": "SOCCER_UNDER_OVER",
            "betItems": [
              {
                "id": "5940732580",
                "code": "O",
                "price": 1.72,
                "isAvailable": true
              },
              {
                "id": "5940732581",
                "code": "U",
                "price": 2.1,
                "isAvailable": true
              }
            ]
          },
        ]
      }
    ],
  }
  ```
</ResponseExample>

## Ready to Start?

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="bolt" href="/quickstart">
    Get up and running in 5 minutes with step-by-step instructions
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/sports/events">
    Explore all 10+ endpoints with interactive examples
  </Card>

  <Card title="Credits & Pricing" icon="tag" href="/credits/pricing">
    Understand our pay-as-you-go credit system and packages
  </Card>

  <Card title="AI Predictions" icon="brain" href="/guides/ai-predictions">
    Learn how to use Mr. Doge Picks and AI recommendations
  </Card>
</CardGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="Join Our Reddit Community" icon="reddit" href="https://www.reddit.com/r/mrdoge/">
    Connect with other developers and get real-time support
  </Card>

  <Card title="Email Support" icon="envelope" href="mailto:support@mrdoge.co">
    Contact our technical support team
  </Card>
</CardGroup>