Skip to main content
GET
/
v2
/
matches
/
trending
Get Trending Events
curl --request GET \
  --url https://api.mrdoge.co/v2/matches/trending \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "123456",
    "competitionId": 1,
    "homeTeamId": 100,
    "awayTeamId": 101,
    "regionId": 1,
    "sportId": 1,
    "startDateTime": "2025-11-08T15:00:00Z",
    "status": "upcoming",
    "views": 1250,
    "metadata": {
      "sportName": "soccer",
      "homeTeamName": "Arsenal",
      "awayTeamName": "Chelsea"
    },
    "mrDogePick": {
      "id": "pick_123456",
      "pickType": "parlay",
      "recommendations": [
        {
          "id": "rec_123456",
          "eventId": "123456",
          "marketId": "mkt_123456",
          "betItemId": "bet_123456",
          "outcome": "Home Win",
          "odds": 2.1,
          "confidence": "High",
          "edgePercentage": 6.8,
          "kellyFraction": 0.032,
          "rationale": [
            "Home team's excellent form (8 wins in last 10)",
            "Away team struggling defensively (10 goals conceded in 3 games)"
          ],
          "riskFactors": [
            "Away team has key players returning from injury"
          ],
          "dataSupport": [
            "Simulation gives 52% home win probability vs 47.6% implied by odds"
          ],
          "settled": false
        }
      ],
      "totalOdds": 8.5,
      "settled": false
    },
    "bettingRecommendations": [
      {
        "id": "rec_123456",
        "eventId": "123456",
        "marketId": "mkt_123456",
        "betItemId": "bet_123456",
        "outcome": "Home Win",
        "odds": 2.1,
        "confidence": "High",
        "edgePercentage": 6.8,
        "kellyFraction": 0.032,
        "rationale": [
          "Home team's excellent form (8 wins in last 10)",
          "Away team struggling defensively (10 goals conceded in 3 games)"
        ],
        "riskFactors": [
          "Away team has key players returning from injury"
        ],
        "dataSupport": [
          "Simulation gives 52% home win probability vs 47.6% implied by odds"
        ],
        "settled": false
      }
    ]
  }
]

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.

Requires Authentication: This endpoint requires an API key and costs 1 credit per request.
Returns the top 5 most-viewed upcoming and live events for today. Perfect for discovering popular betting opportunities and showing users what everyone else is looking at. Events are ranked by view count and include basic event details with key markets. This is a lightweight endpoint optimized for speed - for full AI analysis, use the Event Details endpoint. Use the status parameter to filter by event status (e.g., status=completed to see the most-viewed completed events of the day).
Include the locale query parameter (en, es, or pt) to localize team, competition, and region names.

​
Authorization

​
Authorization
string
default:"Bearer "
required
Your API key for authentication

​
Query Parameters

​
timezone
string
Timezone for calculating “today”Example: America/New_York, Europe/LondonDefault: UTC
​
locale
string
default:"en"
Language for team, competition, and region names. Supported: en, es, pt
​
sport
string
Filter by sport nameOptions: soccer, basketball, baseball, tennis, american-football, ice-hockey, volleyball, handball
​
status
string
default:"upcoming,live"
Filter by event statusOptions: upcoming, live, completedPass multiple statuses with commas: status=upcoming,live or status=completedDefault: Returns upcoming and live events

​
Response

Returns an array of the top 5 most-viewed events for today, filtered by status (default: upcoming and live). Each event includes:
  • Basic event details (teams, competition, region, status)
  • Markets and odds (SOCCER_MATCH_RESULT and SOCCER_UNDER_OVER only)
  • Current view count
Lightweight Endpoint: This endpoint does NOT include:
  • Live stats (stats field)
  • AI betting recommendations
  • Mr. Doge picks
  • Match simulations or analysis
For complete event data with AI analysis, use the Event Details endpoint.

​
Example Request

curl -H "Authorization: Bearer sk_live_..." \
  "https://api.mrdoge.co/v2/matches/trending?sport=soccer&locale=en"
Get Completed Events (Most Viewed Today)
curl -H "Authorization: Bearer sk_live_..." \
  "https://api.mrdoge.co/v2/matches/trending?status=completed&sport=soccer&locale=en"

​
Example Response

{
  "data": [
    {
      "id": "<string>",
      "competitionId": 847,
      "startDateTime": "2025-11-15T15:00:00.000Z",
      "status": "upcoming",
      "views": 104,
      "sport": {
        "name": "soccer"
      },
      "homeTeam": {
        "id": 104932,
        "name": "Manchester City"
      },
      "awayTeam": {
        "id": 158346,
        "name": "Liverpool"
      },
      "competition": {
        "id": 847,
        "caption": "Premier League"
      },
      "markets": [
        {
          "id": "<string>",
          "eventId": "<string>",
          "betTypeSysname": "SOCCER_UNDER_OVER",
          "betItems": [
            {
              "id": "<string>",
              "code": "U",
              "caption": "Under 2.5",
              "instanceCaption": "2.5",
              "price": 1.62,
              "oddsText": "1.62",
              "isAvailable": true
            },
            {
              "id": "<string>",
              "code": "O",
              "caption": "Over 2.5",
              "instanceCaption": "2.5",
              "price": 2.2,
              "oddsText": "2.20",
              "isAvailable": true
            }
          ]
        }
      ],
      "region": {
        "id": 6,
        "caption": "England"
      }
    }
  ],
  "count": 5
}

​
Use Cases

Popular Events

Show users what events are trending

Featured Picks

Highlight AI recommendations for popular games

Discovery

Help users find interesting betting opportunities

Social Proof

Show which events have the most interest

Authorizations

​
Authorization
string
header
required

Use your API key from the Mr. Doge dashboard. Format: Bearer sk_live_... or Bearer sk_test_...

Query Parameters

​
timezone
string

Timezone for 'today' calculation

Example:

"America/New_York"

​
sport
string

Filter by sport name

Example:

"soccer"

Response

Trending events

​
id
string
Example:

"123456"

​
competitionId
integer
Example:

1

​
homeTeamId
integer
deprecated
Example:

100

​
awayTeamId
integer
deprecated
Example:

101

​
regionId
integer
Example:

1

​
sportId
integer
Example:

1

​
startDateTime
string<date-time>
Example:

"2025-11-08T15:00:00Z"

​
status
enum<string>
Available options:
upcoming,
live,
completed
Example:

"upcoming"

​
views
integer
Example:

1250

​
metadata
object

Sport-specific event metadata including teams, markets, and odds

​
mrDogePick
object
​
bettingRecommendations
object[]