Sports Management

At a Glance

What This Section Does

View upcoming sports matches from NBA and Premier League, generate automated prediction markets from match data, refresh betting odds, and manage sports markets throughout their lifecycle.

Who Should Use This

1. Sports Market Managers: Generate and oversee sports prediction markets
2. Market Administrators: Review and manage automated sports markets
3. Operations Staff: Monitor match schedules and refresh odds data

Most Common Tasks

1. View Upcoming Matches: Browse NBA, Premier League, and UEFA Champions League matches
2. Generate Markets: Create prediction markets from match data
3. Refresh Odds: Update betting odds and probabilities from external sources
4. View Market Details: Access detailed information about generated markets

Before You Start

Make sure you have these permissions:

1. admin_market: Required for all sports market operations
2. sport: Required to view the sports matches page
3. Whitelist: "Create & Approve Markets": Required to generate new markets

Overview

Section	Description
Overview	Central hub for viewing upcoming sports matches and generating automated prediction markets from match data and betting odds.
Main Tabs	NBA, Premier League, UEFA Champions League

View & Search Features

Feature	Permission Required	Whitelist Required
Viewing Matches	sport	None
Viewing Market Details	sport	None
Refreshing Odds	sport	None

Create & Manage Features

Feature	Permission Required	Whitelist Required
Generating Markets	admin_market	Create & Approve Markets
Viewing Generated Markets	admin_market	None

1. Sports Matches Management

Overview

Purpose: View upcoming sports matches from multiple leagues, generate automated prediction markets from match data, and manage sports markets throughout their lifecycle.

Key Features:

1. Multi-League Match Viewing Function
2. Automated Market Generation Function
3. Odds Refresh Function
4. Market Details Viewing Function
5. Match Information Display Function

2. League Tabs & Match Overview

Main Tabs

The Sports Matches page is organized into three primary tabs, each representing different sports leagues:

Tab	Description	Data Source
NBA	National Basketball Association matches	External sports data API
Premier League	English Premier League football matches	External sports data API
UEFA Champions League	UEFA Champions League football matches	External sports data API

Tab Behavior

1. Each tab displays matches specific to that league
2. Tabs are independent - switching tabs loads different match data
3. If no matches are available for a league, a message displays: "No upcoming matches found for [League Name]"
4. Match data is automatically fetched from external sports data providers

3. Viewing Upcoming Matches

Purpose

Browse and review upcoming sports matches from NBA, Premier League, and UEFA Champions League to identify opportunities for market generation.

When to Use

Use when you need to:

1. Review upcoming matches scheduled for market generation
2. Check match dates and times
3. View initial probability calculations from betting odds
4. Monitor countdown timers until match start

Steps

Step	Action	Details
1	Access Sports Matches Page	Navigate to Automated Markets > Sport from the main navigation.
2	Select League Tab	Click on the desired league tab: NBA, Premier League, or UEFA Champions League.
3	Review Match Table	The table displays all upcoming matches for the selected league with the following columns:
3.1	Match Column	Shows team abbreviations (e.g., "NYK vs CLE", "NEW vs CHE")
3.2	Date Column	Displays match date and time (e.g., "Dec 26, 12:00 AM")
3.3	Initial Prob Column	Shows calculated probability percentage for the first team (e.g., "58.2%") with an info icon for details
3.4	Countdown Column	Displays time remaining until match start (e.g., "13d 13h 14m 13s")
3.5	Actions Column	Contains either "View Market" or "Generate Market" button depending on market status
4	Use Pagination (if needed)	If more than 10 matches are available, use pagination controls at the bottom to navigate between pages.
5	Adjust Rows Per Page	Use the "Rows per page" dropdown to change how many matches are displayed (default: 10).

Outcome

You can view all upcoming matches for the selected league with key information including match details, probabilities, and available actions.

4. Match Table Structure

Table Columns

Column	Description	Format	Example
Match	Team abbreviations for the matchup	Text	"NYK vs CLE"
Date	Scheduled match date and time	Date/Time	"Dec 26, 12:00 AM"
Initial Prob	Calculated probability for first team based on betting odds	Percentage	"58.2%"
Countdown	Time remaining until match start	Time Duration	"13d 13h 14m 13s"
Actions	Available actions for the match	Button	"View Market" or "Generate Market"

Action Button States

Button	Status	Description
View Market	Market Exists	Market has already been generated. Click to view market details.
Generate Market	No Market	Market has not been generated yet. Click to create a new market.

5. Refreshing Odds

Purpose

Update betting odds and recalculate initial probabilities from external sports data providers to ensure market data is current.

When to Use

Use when you need to:

1. Update stale odds data
2. Refresh probabilities before generating markets
3. Ensure market data reflects latest betting information

Steps

Step	Action	Details
1	Select League Tab	Click on the desired league tab (NBA, Premier League, or UEFA Champions League).
2	Click Refresh Odds	Click the Refresh Odds button located above the match table.
3	Wait for Update	The system fetches the latest odds data from external providers.
4	Review Updated Data	Check the match table for updated initial probabilities and countdown timers.

Outcome

Match data is refreshed with the latest betting odds and probabilities from external sports data providers. Countdown timers are also updated to reflect current time.

Key Notes

1. Refresh operation updates all matches in the current tab
2. Refresh may take a few seconds depending on data provider response time
3. Initial probabilities are automatically recalculated from updated odds
4. Countdown timers are synchronized with the current server time

6. Generating Markets from Matches

Purpose

Create automated prediction markets from sports match data using AI-generated resolution rules and calculated probabilities from betting odds.

When to Use

Use when you want to:

1. Create a new prediction market for an upcoming match
2. Generate markets automatically with AI assistance
3. Set up markets with custom probability overrides

Steps

Step	Action	Details
1	Select League Tab	Navigate to the league tab containing the desired match (NBA, Premier League, or UEFA Champions League).
2	Locate Match	Find the match in the table that shows "Generate Market" in the Actions column.
3	Click Generate Market	Click the Generate Market button for the desired match.
4	Review Generate Market Modal	A modal dialog appears with the following information:
4.1	Match Information	Displays league name, team names, match date and time
4.2	Betting Odds	Shows moneyline odds (ML) for both teams (e.g., "ML: -437" for favorite, "ML: +292" for underdog)
4.3	Initial Probability Section	Displays calculated probabilities from odds with override option
5	Review Initial Probabilities	The modal shows:
5.1	Calculated Probabilities	Automatically calculated from betting odds (e.g., "Brighton & Hove Albion: 81.4%", "Sunderland: 25.5%")
5.2	Override Toggle	Switch to manually override calculated probabilities if needed
5.3	Source Information	Displays "Calculated from odds:" to indicate probability source
6	Optional: View Bookmaker Odds	Click View Bookmaker Odds button to see detailed odds information.
7	Optional: Advanced Settings	Click Advanced button to access additional market configuration options.
8	Generate Market	Click the Generate button to create the market with AI-generated resolution rules.
9	Close Modal	Alternatively, click Close to cancel market generation.

Outcome

After successful generation:

1. A new prediction market is created with the match question
2. Market uses custom outcome names (team names) instead of Yes/No
3. Initial probabilities are set based on betting odds (or overridden values)
4. AI-generated resolution rules are automatically created
5. Market appears in the "Proposed" status in Admin Markets
6. The match row updates to show "View Market" instead of "Generate Market"

Key Notes

1. Market generation uses AI to create resolution rules automatically
2. Markets are created with custom outcome names matching team names
3. Initial probabilities are calculated from betting odds unless overridden
4. Generated markets start in "Proposed" status and require approval before publishing
5. Once a market is generated, the match row will show "View Market" button
6. Markets cannot be regenerated - if a market exists, you can only view it

7. Viewing Market Details

Purpose

Access detailed information about a generated sports market, including market status, trading activity, and market information.

When to Use

Use when you need to:

• Review market details after generation
• Check market status and activity
• View market information and blockchain addresses
• Access market management actions

Steps

Step	Action	Details
1	Select League Tab	Navigate to the league tab containing the desired match.
2	Locate Match	Find the match in the table that shows "View Market" in the Actions column.
3	Click View Market	Click the View Market button for the desired match.
4	Review Market Details Page	The page displays comprehensive market information:
4.1	Market Header	Shows market question (e.g., "NEW vs CHE?") with status badge
4.2	Action Buttons	"View Resolution Rules", "Preview", "Propose" buttons for market management
4.3	Market Statistics	Total Volume, Total Value Locked, Total Liquidity, Fees information
4.4	Sports Market Information	Decimal Odds, American Odds, Probability percentages, Sports Game Odds ID
4.5	Market Activity Tab	Shows audit log of market lifecycle events (Created, Approved, Live, Archived, etc.)
4.6	Recent Orders Tab	Displays recent trading activity for the market
4.7	Market Information Panel	Status, Type, Category, Tags, Creator, Created At, Expires At, Market ID, Question ID, Market Address, Question Market Address, Condition ID, Presale Address ID, Panda Score Match ID
5	Navigate Back	Click Back to Markets button to return to the sports matches list.

Market Details Page Sections

Market Statistics

Metric	Description
Total Volume (Taker)	Cumulative trading volume from taker orders
Total Value Locked	Total collateral locked in the market
Total Liquidity	Total liquidity provided to the market
Fees	Trading Fee, Merge Fee, Redeem Fee percentages

Sports Market Information

Field	Description	Example
Decimal Odds	European format betting odds	"NEW 1.74 - CHE 2.00"
American Odds	US format betting odds	"NEW -136 - CHE +100"
Probability (%)	Win probability for each team	"NEW 57.6% - CHE 50.0%"
Sports Game Odds ID	External sports data provider match ID	"GITX7hYrzL3cVG6IRGPP"

Market Activity

The Market Activity tab shows a chronological audit log of all market lifecycle events:

Event Type	Description
Market Created	Initial market creation with details
Market Approved	Market approved by admin
Market Live	Market published and open for trading
Market Archived	Market removed from public view

Each event shows:

1. Event title and description
2. User who performed the action (with link to user profile)
3. Timestamp of the event

Market Information Panel

Field	Description
Status	Current market status (Proposed, Approved, Live, Archived, etc.)
Type	Market type (Binary Market)
Category	Market category (Sports)
Tags	Associated tags (e.g., "AI-generated", "Creator")
Creator	User who created the market (with link to profile)
Created At	Market creation timestamp
Expires At	Market expiration date and time
Market ID	Internal unique identifier
Question ID	Blockchain identifier for the question
Market Address	Blockchain address for the market contract
Question Market Address	Blockchain address for the question market contract
Condition ID	Blockchain identifier for the condition
Presale Address ID	Presale contract address (if applicable)
Panda Score Match ID	External match ID (if applicable)

Outcome

You can view comprehensive details about the generated sports market, including status, statistics, trading activity, and blockchain information.

8. Best Practices for Sports Matches Management

Market Generation

1. Review Odds Before Generating: Always refresh odds before generating markets to ensure current data
2. Verify Match Information: Confirm match date, time, and team names are correct before generating
3. Check for Existing Markets: Verify no market already exists for the match before generating
4. Use Override Sparingly: Only override calculated probabilities when you have specific reasons
5. Review Generated Markets: Always review AI-generated resolution rules before approving markets

Odds Management

1. Regular Refresh: Refresh odds periodically to keep market data current
2. Monitor Probability Changes: Watch for significant probability shifts that may indicate data issues
3. Verify Data Sources: Ensure external sports data providers are functioning correctly

Market Review

1. Check Market Status: Verify market status after generation (should be "Proposed")
2. Review Resolution Rules: Ensure AI-generated rules are clear and accurate
3. Verify Outcome Names: Confirm custom outcome names match team names correctly
4. Check Expiration Dates: Ensure expiration dates align with match schedules

Workflow Efficiency

1. Batch Operations: Generate markets for multiple matches in a session
2. Use Filters: Leverage league tabs to focus on specific sports
3. Monitor Countdowns: Use countdown timers to prioritize matches approaching start time
4. Track Market Lifecycle: Review Market Activity tab to understand market history

9. Troubleshooting

Common Issues

Issue	Possible Cause	Solution
"No upcoming matches found"	No matches scheduled for the league	Check if matches are scheduled for the selected league
"Generate Market" button not working	Missing permissions	Verify you have "Create & Approve Markets" whitelist permission
Odds not refreshing	External API issue	Wait a few moments and try again, or check external data provider status
Market already exists	Market was previously generated	Use "View Market" button instead to access existing market
Probabilities seem incorrect	Stale odds data	Click "Refresh Odds" to update data from external providers

Error Messages

1. Permission Denied: You don't have required permissions. Contact administrator to grant "Create & Approve Markets" whitelist.
2. Market Generation Failed: Check network connection and try again. Verify match data is valid.
3. Odds Refresh Failed: External sports data provider may be unavailable. Try again later.

Product Glossary

Term	Description
Initial Probability	Calculated win probability for the first team based on betting odds from external sports data providers
Generate Market	Action to create a new prediction market from sports match data with AI-generated resolution rules
View Market	Action to access detailed information about an existing generated market
Refresh Odds	Action to update betting odds and probabilities from external sports data providers
Countdown	Time remaining until the scheduled match start time
Match	Sports game between two teams with scheduled date and time
League Tab	Tab interface to switch between different sports leagues (NBA, Premier League, UEFA Champions League)
Decimal Odds	European format betting odds (e.g., 1.74 means bet $1 to win $0.74 profit)
American Odds	US format betting odds (e.g., -136 means bet $136 to win $100 profit)
Moneyline (ML)	Betting format showing odds for team to win the match
Sports Game Odds ID	Unique identifier from external sports data provider for the match
Custom Outcome Names	Team names used as market outcomes instead of default "Yes/No" labels
AI-Generated Resolution Rules	Automatically created market resolution criteria using artificial intelligence
Override Toggle	Option to manually set probabilities instead of using calculated values from odds
Market Activity	Audit log showing all lifecycle events for a market (Created, Approved, Live, Archived, etc.)
Market Details Page	Comprehensive view of market information, statistics, and management options